NdisClDropParty

NDIS_STATUS

  NdisClDropParty(

    IN NDIS_HANDLE  NdisPartyHandle,

    IN PVOID  Buffer  OPTIONAL,

    IN UINT  Size 

    );

NdisClDropParty함수는 클라이언트의 멀티포인트 VC로부터 party를 드랍한다.

매개변수

NdisPartyHandle
멀티 포인트 연결에 드랍된 party를 확인하기위한 핸들을 지정한다. 클라이언트는 NdisClAddParty 혹은 NdisClMakeCall함수의 이전 호출로부터 이핸들을 얻는다.

Buffer
리모트 노드의 party의 멀티포인트 연결을 닫기위해 전송되어진 어떤 데이타를 포함하는 호출자 할당 버퍼의 포인터. 하위 미디엄에 의존하는 이 포인터는 NULL일수 있다. 예를들어, 이 파라미터는 ATM네트웍에서 NULL이다.

Size
Buffer에 바이트 크기를 지정한다. 만약 Buffer가 NULL이면 0이다.

리턴값

NdisClDropParty함수는 NDIS_STATUS_PENDING이외의 다른 어떤것을 리턴했을때, 클라이언트는 ProtocolClDropPartyComplete함수의 내부적인 호출을 해야만한다. 그렇지 않으면, NDIS는 클라이언트의 ProtocolClDropPartyComplete함수를 이연산이 끝났을때 호출한다.

주석

클라이언트는 일반적으로 다음 환경중 어느하나에서 NdisClDropParty함수를 호출한다.

  • ProtocolClIncomingDropParty함수로부터 멀티포인트 연결로부터의 주어진 party를 제거하기위해.

    리모트 노드의 party가 NdisClCloseCall함수로 연결을 닫을때 발생한다. NDIS가 로컬 클라이언트의 ProtocolClDropPartyComplete 함수를 리턴할때, 클라이언트가 이 party에대한 상태를 유지하고 있는 ProtocolPartyContext에서의 컨택스트영역을 해제하고 재사용 할수있다.

  • 클라이언트가 클라이언트가 처음에 NdisClMakeCall함수로 설정한 멀티포인트 연결에대한 마지막 party로 NdisClCloseCall함수를 호출하기전에

    그런 클라이언트가 초기화한 자기자신의 멀티포인트 호출의 종료에대헤, 클라이언트는 멀티포인트 VC에대해 모든 남아있는 party를 드랍하기위해 한번 혹은 그이상 NdisClDropParty함수를 호출한다.

NdisClDropParty함수의 클라이언트의 호출은 NDIS가 멀티포인트 VC에대한 같은 NdisVcHandle을 공유하는 콜매니저의 ProtocolCmDropParty함수를 호출하도록 한다. 콜 매니저는 리모트 노드 피어에게 party연결이 닫혀져야 한다는것을 알려야할 책임이 있다. 클라이언트가 드랍-party연산을 초기화한다는것에 의존하여.

일반적인 지침으로써, NdisClCloseCall함수로 멀티포인트 연결을 닫기전에, 클라이언트는 NdisClMakeCall함수로 부터 얻어진 특별한 NdisVcHandle로 NdisClAddParty함수를 호출하는 만큼 NdisClDropParty함수를 호출해야만한다. 로컬 클라이언트의 ProtocolClIncomingDropParty함수의 호출로 인하여 리모트 party들이 그들의 연결들을 닫는것을 초기화 할수 있기때문에, 로컬 클라이언트는 얼마나 많은 호출이 NdisClCloseCall함수를 호출할수있기전에 NdisClDropParty함수를 호출해야만 하는지 알기위해 멀티포인트 VC들에대한 엑티브 party의 숫자를 계속해서 트랙해야만한다.

그러나, 클라이언트는 NdisClCloseCall함수에게 클라이언트가 처음에 멀티포인트 연결을 설정했을때 NdisClMakeCall함수에의해 리턴된 같은 NdisPartyHandle을 넘겨주도록 요구되어지지 않는다. 클라이언트는 다른 순서로 멀티포인트에대한 party를 해제할수 있다. NdisClDropParty함수의 호출에서 NdisClAddParty 혹은 NdisClMakeCall함수에의해 리턴된 모든 NdisPartyHandle을 해제하는한, 같은 멀티포인트 VC에대한 NdisClCloseCall함수에대한 마지막 party 핸들로 처음의 호출에의해 이어지는. 클라이언트는 멀티포인트 호출을 닫은후, NdisCoDeleteVc함수로 처음에 만들어진 VC를 해제 할수 있다.

NdisClDropParty함수의 호출자는 이함수를 호출하자마자 입력 NdisPartyHandle을 타당하지 않다고 간주해야한다. 만약 이핸들을 할당된 party컨텍스트 영역내에 저장한다면, party가 드랍됐을때 만약 재사용을 위해 party당 컨택스트 영역을 재초기화 한다면 클라이언트의 ProtocolClDropPartyComplete함수는 핸들 변수를 NULL로 재 설정해야만한다.

NdisClDropParty함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.