NdisClCloseCall

NDIS_STATUS NdisClCloseCall( IN NDIS_HANDLE NdisVcHandle, IN NDIS_HANDLE NdisPartyHandle OPTIONAL, IN PVOID Buffer OPTIONAL, IN UINT Size );

NdisClCloseCall은 지정된 VC의 해제를 요청한다.

매개변수

NdisVcHandle

닫혀지거나 연결해제되고있는 VC의 핸들을 지정한다. 나가는 호출을 만드는 것에대한 준비에서의 클라이언트에 의해서인지 혹은 클라이언트로 들어오는 호출을 가져오는것에대해 준비하는 콜메니저에의해서인지는, VC가 NdisCoCreateVc함수로 처음에 만들어 질때 이핸들은 NDIS에의해 제공된다.

NdisPartyHandle

멀티포인트 VC에서 드랍된 마지막 party에대한 핸들 혹은 NULL을 지정한다. 만약 이것이 멀티포인트 VC이면, 클라이언트는 NdisClMakeCall 혹은 NdisClAddParty의 앞선 호출로부터의 이핸들을 얻는다.

Buffer

연결이 닫힐때, 리모트 노드의 party로 전송되어지는 어떤 데이타를 포함하는 호출자 제공 버퍼의 포인터. 하위 미디엄에 의존하여, 이포인터는 NULL일수 있다. 예를들어, 이 파라미터는 ATM네트웍에서는 NULL이다.

Size

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

리턴값

NdisClCloseCall함수가 NDIS_STATUS_PENDING이외의 다른것을 리턴할때, 클라이언트는 ProtocolClCloseCallComplete함수의 내부적인 호출을 이루어야한다. 그렇지 않으면, NDIS는 이 연산이 완료됐을때, 클라이언트의 ProtocolClCloseCallComplete함수를 호출한다.

주석

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

• 성립된 콜을 닫기위해, 호출이 NdisClMakeCall함수로 클라이언트에의해 초기화되든 아니면 리모트 피어의의해 제공되든지 그리고 클라이언트의 ProtocolClIncomingCall함수에의해 받아들여질때.
• ProtocolClIncomingCloseCall함수로부터 성립된 호출을 해제하기위해.

  리모트 party가 리모트 party가 처음 초기화하고 클라이언트가 받아들인 들어오는 호출을 닫을때 이것은 발생한다. 클라이 언트 초기화의 나가는 호출에대해, 리모트 party가 리모트 노드에서의 포인트-to-포인트 연결을 닫거나 멀티포인트 VC의 마 지막 남아있는 party가 리모트 노드의 호출을 닫을때, 발생한다.

• ProtocolClMakeCallComplete함수로부터 나가는 호출을 만드는 클라이언트 초기화의 시도를 해재.

  만약 콜메니저가 NdisClMakeCall함수에게 넘기는 클라이언트 지정 콜 파라미터를 수정한다면 발생하고 클라이언트는 이 수 정을 받아들일수 없게 한다.(애매)

• ProtocolClIncomingQoSChange함수로부터 성립된 호출을 해제하기위해.

  만약 VC에서 다른 party에의해 제안된 QoS변화가 클라이언트로 받아들여질수 없다면 발생한다.

• ProtocolClModifyCallQoSComplete함수로부터 성립된 호출을 해재를 위해.

  이것은 만약 클라이언트가 제안한 VC에대한 QoS가 받아들여지지않고 ProtocolClModifyCallQoSComplete함수로 리턴된 CM-수 정의 QoS가 클라이언트에게 받아들여지지않는다면 발생한다.

클라이언트가 만든 멀티포인트 VC에의 성립된 호출을 해제하기위해, 클라이언트는 NdisClDropParty를 NdisClCloseCall를 호출하기전에 VC에대한 마지막 party를 제외하고 해제하기위해 한번 혹은 그이상을 호출해야한다. 콜매니저는 만약 주어진 VC가 여전히 하나이상의 연결된party를 가지고 있다면 멀티 포인트 호출을 닫기위해 어떤 클라이언트의 요청을 실패 할것이다. NdisClCloseCall에게 넘겨준 NdisPartyHandle은 클라이언트가 주어진 NdisVcHandle로 NdisClAddParty 혹은 NdisClMakeCall에대한 선행하는 호출로부터 어떤 타당한 핸들일수 있다.

클라이언트가 초기화한 멀티포인트에대한 리모트 party가 그들의 닫혀진 연결에대한 요청을 할때, NDIS는 하나 이상의 미해결된 party가 클라이언트가 만든 멀티포인트 VC에 존재하는한 그 클라이언트의 ProtocolClDropParty함수를 호출한다. 마지막 남아있는 리모트 party가 그 연결을 닫을때, NDIS는 클라이언트의 ProtocolClIncomingCloseCall함수를 대신 호출한다. 결과적으로, 멀티 포인트 연결을 설정하는 어떤 클라이언트의 ProtocolClIncomingCloseCall함수는 그 멀티포인트 VC들에대한 마지막으로 남아있는 party를 확인해야만 하고 적절한 NdisPartyHandle을 NdisClCloseCall에게 넘겨야한다.

클라이언트가 NdisClCloseCall함수로 NdisPartyHandle를 해제한후, 그것이 유지하고있는 party당 상태에대한 리소스들을 해제(재사용을 위해 재초기화하거나) 할 수 있다. 그러나, 클라이언트는 NdisClCloseCall함수로 초기화하는 연산의 완료에 있어 같은방법으로 VC당 리소스들을 해제하거나 재사용할수 없다. 왜냐하면 closing으로써 마크됐기때문에 다른 호출을 만들기위해 재사용할수없는 NdisVcHandle이 VC가 없어질때까지 여전히 타당하기때문이다. 클라이언트가 만약 VC당 리소스들을 해제하거나 초기화하기전에 나가는 호출에대한 VC를 만들었다면 NdisCoDeleteVc함수를 호출해야만하거나, 클라이언트가 ProtocolCoDeleteVc함수가 호출되기전까지 이러한 리소스들에대한 해제와 초기화를 지연해야만한다.

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