NdisCmDispatchIncomingDropParty

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

일반적으로 콜 매니저는 네트웍 상으로 활성화된 멀티포인트 연결을 닫으라는 요청을 받기때에, NdisCmDispatchIncomingDropParty함수는 클라이언트에게 멀티포인트 VC에대한 지정된 party를 제거햐야한다는 것을 알린다.

매개변수

DropStatus

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

NdisPartyHandle

여전히 연결된 다른 party들을 가지고 있어야만 하는 멀티포인트 VC로부터 드랍된 party를 확인하는 핸들을 지정한다.

Buffer

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

Size

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

주석

일반적인 네트웍 연산의 코스에서, 독립적인 콜 매니저의 ProtocolCoReceivePacket함수는 CloseStatus의 NDIS_STATUS_SUCCESS로 설정하여 NdisCmDispatchIncomingDropParty함수를 호출한다. 왜냐하면 멀티포인터 연결의 리모트 클라이언트가 NdisClCloseCall함수를 호출했기때문에.

그러나, 콜 매니저는 또한 일반적이지 않은 즉,로컬 클라이언트와 성립된 멀티포인트 연결의 하나혹은 그이상의 클라이언트들사이의 경로에 스위치의 실패와 같은 네트웍 상황이 발생한다면 네트웍의 요청에 CM의존 CloseStatus로 NdisCmDispatchIncomingDropParty함수를 호출한다.

NdisCmDispatchIncomingDropParty함수의 호출은 NDIS로 하여금 클라이언트의 ProtocolClIncomingDropParty함수의 호출을 야기한다.

만약 NdisPartyHandle이 주어진 VC의 마지막 남아있는 party를 확인한다면, CM은 NdisCmDispatchIncomingDropParty함수보다는 오히려 NdisCmDispatchIncomingCloseCall함수를 호출한다.

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

NdisCmDispatchIncomingDropParty의 호출자는 IRQL <= DISPATCH_LEVEL로 동작될수 있다.