ProtocolClIncomingDropParty
VOID
ProtocolClIncomingDropParty(
IN NDIS_STATUS DropStatus,
IN NDIS_HANDLE ProtocolPartyContext,
IN PVOID CloseData OPTIONAL,
IN UINT Size OPTIONAL
);
|
멀티포인트 연결들을 설정하는 연결지향 NDIS 클라이언트들은 ProtocolClIncomingDropParty 함수들을 가져야 한다. 그렇지 않으면, 그러한 프로토콜 드라이버의 등록된 ProtocolClIncomingDropParty 함수는 간단히 제어를 리턴한다.
매개변수
- DropStatus
- 파티가 드랍된 이유를 가리킨다. 항상 이 값은 만약 리모트 노드(note??)에서 파티가 연결의 닫힘을 초기화한다면 NDIS_STATUS_SUCCESS이지만, 만약 콜 매니저가 발견된 네트워크 문제들 때문에 이러한 드랍 파티 연산을 초기화한다면 어떤 CM결정 상태가 될 것이다.
- ProtocolPartyContext
- 파티가 드랍된 클라이언트의 파티당 컨텍스트 영역에 대한 핸들을 지정한다. 클라이언트는 원래 이러한 핸들을 NdisClAddParty 함수 혹은 NdisClMakeCall 함수를 호출할 때 NDIS에게 제공한다.
- CloseData
- 콜 매니저가 네트워크에서 수신된 리모트 클라이언트에 의해 제공된 하나의 값으로 프로토콜 특정 닫힘 메시지를 포함하는 버퍼를 가리키거나 이 매개변수는 NULL이 될 수 있다.
DropStatus가 NDIS_STATUS_SUCCESS일 때, 만약 아래 네트워크 미디엄이 연결을 닫을 때 데이터의 전송을 지원하지 않는다면 NULL이다. 그러나, 어떤 특정 콜 매니저가 네트워크에서 문제들의 의해 야기된 드랍 파티 연산들에서 클라이언트들에 대한 추가적인 진단 정보를 전달하기 위해 구조체를 정의해야 할 것이다.
- Size
- 만약 CloseData가 NULL이면 0이고 CloseData 버퍼의 바이트 길이를 지정한다.
주석
ProtocolClIncomingDropParty 함수에 대한 호출이 다음과 같은 하나가 발생했다는 것을 가리킨다:
- 콜 매니저는 클라이언트가 ProtocolPartyContext에 파티당 컨텍스트 영역내에 저장된 NdisPartyHandle에 의해 지정된 설립된 연결을 닫기 위해 네트워크에 대한 요구를 수신한다.
- 콜 매니저는 네트워크 문제들이 설립된 연결에서 데이터 전송들을 막을 것이라는 것을 감지했다.
이러한 경우에, ProtocolClIncomingDropParty 함수는 클라이언트의 멀티 포인트 VC로부터 파티를 드랍하기 위해 어떤 프로토콜 결정 연산들을 실행해야 하낟. ProtocolClIncomingDropParty 함수는 NdisClDropParty 함수를 호출해야 하거나, 만약 이것이 클라이언트의 멀티포인트 VC에서 마지막 남아있는 파티이면 NdisClCloseCall 함수를 호출해야 한다.
ProtocolClIncomingDropParty 함수는 클라이언트가 NdisClAddParty 함수 혹은 NdisClMakeCall 함수로부터 얻은 NdisPartyHandle이 유효하지 않는 것으로 여겨져야 한다. ProtocolClIncomingDropParty 함수는 클라이언트의 파티당 컨텍스트 영역을 해제할 수 있거나 NdisClAddParty 함수에 대한 계속적인 호출에서 재사용을 위해 그것을 준비할 수 있다.
ProtocolClIncomingDropParty 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.
|