NdisMCmDispatchIncomingDropParty

VOID NdisMCmDispatchIncomingDropParty( IN NDIS_STATUS DropStatus, IN NDIS_HANDLE NdisPartyHandle, IN PVOID Buffer OPTIONAL, IN UINT Size );

NdisMCmDispatchIncomingDropParty함수는 클라이언트에게 멀티포인트 VC에대한 특정한 파티를 제거햐야만 한다는것을 알린다.

매개변수

DropStatus

이 파티가 드랍되어지는 이유를 인디케이트 한다. 만약 리모트 파티가 단순히 연결을 닫는것을 요청한다면, 일반적으로 NDIS_STATUS_SUCCESS 이다.

NdisPartyHandle

여전히 연결되어 있는 다른 파티를 가지고 있어야만 하는 멀티포인트 VC로부터 드랍된 파티를 인디케이트 하는 핸들을 지정한다. MCM드라이버는 처음에 ProtocolCmAddParty함수에대한 입력 파라미터로써 이 핸들을 얻는다.

Buffer

리모트 파티로부터 받은 추가적인 프로토콜 지정 데이타 호출자 할당 상주 버퍼의 포인터. 하위 미디엄에 의존하여, 이 포인터는 NULL일수 있다. 예를들어, 이 파라미터는 ATM네트웍에서는 NULL이다.

Size

버퍼의 바이트 크기를 지정한다. 만약 Buffer가 NULL이면 0이다.

주석

일반적인 네트웍 연산들에서, MCM드라이버는 CloseStatus을 NDIS_STATUS_SUCCESS로 하여 NdisMCmDispatchIncomingDropParty함수를 호출한다. 왜냐하면, 멀티포인트 연결에서의 리모트 클라이언트는 NdisClCloseCall함수를 호출하기때문이다.

그러나, 만약 로컬 클라이언트와 하나 혹은 그이상의 성립된 멀티포인트 연결사이에 경로에 스위치의 실패와 같은 비정상적인 네트웍 연결이 발생한다면, MCM미니포트는 또한 네트웍 요청에 드라이버 의존 CloseStatus으로 NdisMCmDispatchIncomingDropParty함수를 호출할 수 있다.

NdisMCmDispatchIncomingDropParty함수에대한 호출은 .NDIS가 클라이언트의 ProtocolClIncomingDropParty함수를 호출하도록 한다.

만약, NdisPartyHandle이 주어진 VC에대해 마지막으로 남아있는 파티를 확인한다면, MCM드라이버는 NdisMCmDispatchIncomingDropParty함수보다는 NdisMCmDispatchIncomingCloseCall함수를 호출할것이다.

통합 콜 매니지먼트를 지원하는 연결지향 닉 미니포트만이 NdisMCmDispatchIncomingDropParty함수를 호출할수 있다. 스스로를 NDIS에게 독립적인 프로토콜로써 등록하는 독립적인 콜 매니저들은, 대신 NdisCmDispatchIncomingDropParty함수를 호출한다.

NdisMCmDispatchIncomingDropParty함수의 호출은 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.