ProtocolClDropPartyComplete

VOID ProtocolClDropPartyComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE ProtocolPartyContext );

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

매개변수

Status

다음과 같은 값들중 하나가 될 수 있는 클라이언트 초기화된 drop-party 연산의 마지막 상태를 지정한다.

NDIS_STATUS_SUCCESS

파티가 드랍되었다. 클라이언트가 ProtocolPartyContext 영역에 저장된 이러한 파티를 표시하는 NdisPartyHandle는 지금 유효하지 않다.

NDIS_STATUS_FAILURE

주어진 파티는 클라이언트의 멀티포인트 VC에서 마지막 남아있는 것이다. 그러므로, 클라이언트는 이러한 파티를 드랍하기 위해 NdisClCloseCall 함수를 호출해야 한다.

ProtocolPartyContext

클라이언트가 원래 NdisClAddParty 혹은 NdisClMakeCall 함수를 호출할 때 NDIS에게 제공된 클라이언트의 파티당 컨텍스트 영역에 대한 핸들을 지정한다.

주석

ProtocolClDropPartyComplete 함수에 대한 호출은 콜 매니저가 NdisClDropParty함수에 대한 클라이언트의 전에 호출에 의해 초기화된 요구의 처리를 완성하는 것을 가리킨다. ProtocolClDropPartyComplete 함수는 클라이언트 할당 파티당 컨텍스트 영역을 해제할 수 있거나 NdisClAddParty에 대한 계속적인 호출에서 재사용을 위해 그것을 준비할 수 있다.

만약 클라이언트가 만든 멀티 포인트 VC를 끊는 과정에 있다면, ProtocolClDropPartyComplete 함수는 클라이언트의 활성화한 멀티포인트 VC에 대한 남아있는 파티들의 하나에 대한 어떤 유효한 NdisPartyHandle로 NdisClDropParty 함수를 호출할 수 있다. 만약 단지 하나 이상의 파티가 멀티포인트 VC에 남아있다면, 클라이언트는 NdisClCloseCall 함수에 NdisPartyHandle를 전달함으로써 그러한 파티를 드랍해야 한다.

ProtocolClDropPartyComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.