ProtocolClMakeCallComplete

VOID ProtocolClMakeCallComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE ProtocolVcContext, IN NDIS_HANDLE NdisPartyHandle OPTIONAL, IN PCO_CALL_PARAMETERS CallParameters );

나가는 호출들을 만드는 연결 지향 NDIS 클라이언트들은 그들이 NdisClMakeCall 함수로 초기화한 비동기 연산들을 완성하기 위해 ProtocolClMakeCallComplete 함수들을 가져야 한다. 그렇지 않으면, 그러한 프로토콜 드라이버의 등록된 ProtocolClMakeCallComplete 함수는 간단히 제어를 리턴할 수 있다.

매개변수

Status

다음과 같은 하나의 값이 될 수 있는 NdisClMakeCall에 대한 클라이언트의 원래 호출의 마지막 상태를 지정한다.

NDIS_STATUS_SUCCESS

가상 연결을 설정하기 위한 클라이언트의 시도가 성공이다. 결과적으로, 클라이언트는 클라이언트가 ProtocolVcContext에서 VC 당 연결 컨텍스트 영역내에 저장된 NdisCoCreateVc함수에 의해 리턴된 NdisVcHandle를 사용하여 활성화 VC에 전송들을 처리할 수 있다.

NDIS_STATUS_RESOURCES

NDIS, 콜 매니저, 혹은 아래 드라이버가 연결들을 설정하기 위한 충분한 자원들을 할당할 수 없다.

NDIS_STATUS_XXX

콜 매니저 혹은 아래 미니포트는 활성화 연결을 설립하는 것이 실패했고 NDIS는 클라이언트에게 이러한 드라이버 결정 실패 상태를 전달한다.

ProtocolVcContext

클라이언트가 원래 나가는 호출을 위한 VC를 설정하기 위해 NdisCoCreateVc 함수를 호출할 때 NDIS에게 제공하는 클라이언트의 VC당 컨텍스트 영역에 대한 핸들을 지정한다.

NdisPartyHandle

만약 Status가 NDIS_STATUS_SUCCESS이고 클라이언트가 NdisClMakeCall함수에 외연적인 ProtocolPartyContext 핸들을 전달함으로써 멀티포이트 VC를 만든다면, 이것은 유효한 NdisPartyHandle이다. 그렇지 않으면, 이러한 매개변수는 NULL이다.

ProtocolClMakeCallComplete 함수는 항상 클라이언트의 파티당 컨텍스트 영역내에 어떤 유효한 입력 NdisPartyHandle을 저장해야 한다. 클라이언트는 만약 이러한 파티를 참조하는 NdisClDropParty 함수 혹은 NdisClCloseCall 함수에 대한 연속된 호출을 한다면(할 때) 이러한 핸들을 사용할 수 있다.

CallParameters

버퍼화된 CO_CALL_PARAMETERS 구조체를 가리킨다. 클라이언트는 NdisClMakeCall 함수에 이러한 포인터를 전달하기 전에 클라이언트 결정 데이터로 이러한 구조체를 초기화하고 이러한 버퍼를 할당한다. 클라이언트의 요구를 처리할 때, 콜 매니저는 네트워크 혹은 시그널링 피어로 협상의 결과를 반영하기 위해 이러한 데이터를 수정할 수 있다.

주석

ProtocolClMakeCallComplete 함수에 대한 호출은 콜 매니저가 NdisClMakeCall 함수로 가상 연결을 설립하기 위해 클라이언트의 요구를 처리하는 것을 완성하는 것을 가리킨다.

만약 클라이언트의 나가는 호출을 설립하기 위한 시도가 성공적이지 못하면(입력 Status가 NDIS_STATUS_SUCCESS를 제외한 어떤것), ProtocolClMakeCallComplete 함수는 다음과 같은 일을 한다:

• ProtocolPartyContext 영역과 클라이언트가 할당한 CallParameters 버퍼를 재사용을 위해 해제하고 준비한다.
• NdisCoDeleteVc 함수에 대한 호출로 클라이언트가 만든 VC를 끊고 클라이언트 할당 ProtocolVcContext 영역을 재사용을 위해 해제하거나 준비한다.

1. 콜 매니저가 클라이언트 제공 콜 매개변수들을 수정하는 것을 가리키는 CALL_PARAMETERS_CHANGED가 설정되었는지를 알기 위해 CallParameters 구조체의 Flags 멤버를 체크한다.
2. 만약 그렇다면, 그들이 이러한 연결을 위해 수락할 수 있는 지를 결정하기 위해 CallParameters 데이터를 조사한다.

   예를 들어, 클라이언트는 활성화 VC를 위한 버퍼화된 호출을 보류하고, 만약 이것이 멀티포인트 VC이면 NdisPartyHandle을 저장하고, 일반적으로 클라이언트는 만약 주어진 콜 매개변수들이 만족하다면 활성화 VC에서 다른 연산들과 연속된 전송들을 준비한다.

3. 만약 아니면, 시그널링 프로토콜은 클라이언트는 콜 매니저로 수락할 수 있는 콜 매개변수들을 위해 재협상하려고 시도할 수 있는지 결정한다.

   예를 들어, 특정 콜 매니저는 이러한 환경에서, 한번 혹은 여러번 NdisClModifyCallQoS 함수를 호출하는 것을 클라이언트들에게 허락한다.

4. 만약 CM-수정 콜 매개변수들이 수락할 수 없고 더 나아가 재협상이 불가능하다면, ProtocolClMakeCallComplete 함수는 NdisClCloseCall 함수로 호출을 끊어야 한다.

   이러한 경우에, ProtocolClMakeCallComplete 함수는 NdisClCloseCall 함수로부터 리턴되자마자 어떤 클라이언트 할당 자원들을 해제하는 시도를 할 필요가 없지만 간단히 제어를 리턴할 수 있다. 그 대신에, 클라이언트는 ProtocolClCloseCallComplete 함수내에 할당한 자원들을 해제해야 한다. (혹은 재사용을 위해 그들을 준비한다.)