NdisCmCloseCallComplete

VOID NdisCmCloseCallComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE NdisVcHandle, IN NDIS_HANDLE NdisPartyHandle OPTIONAL );

NdisCmCloseCallComplete함수는 콜 매니저가 이전에 콜을 해제하기위해 NDIS_STATUS_PENDING을 리턴한것에대해 클라이언트의 요청의 마지막 상태를 리턴한다.

매개변수

Status

CM이 연결을 닫는 클라이언트의 요청의 마지막 상태를 지정한다. NDIS_STATUS_SUCCESS혹은 NDIS_STATUS_PENDING을 제외한 CM-의존 NDIS_STATUS_XXX.

NdisVcHandle

호출에 대한 VC의 핸들을 지정한다. 이 핸들은 NdisCoCreateVc함수로 콜 매니저 혹은 클라이언트에의해 VC가 처음에 만들어 졌을때 NDIS에의해 제공된다. 더 최근에, 콜 매니저는 이 핸들을 ProtocolCmCloseCall함수의 입력 파라미터로써 넘겨진 CallMgrVcContext에의해 설계된 VC당 상태로부터 이핸들을 얻는다.

NdisPartyHandle

만약 NdisVcHandle이 포인트-포인트 VC이면 NULL 혹은 멀티포인트 연결에 마지막 남아있는 party의 핸들, CM이 ProtocolCmCloseCall함수의 입력 파라미터로써 넘겨지는 CallMgrPartyContext에의해 설계된 party당 상태로부터 얻는다.

주석

만약 독립적인 콜 매니저의 ProtocolCmCloseCall함수가 NDIS_STATUS_PENDING을 리턴한다면, CM은 NdisCmCloseCallComplete함수를 클라이언트와 NDIS에게 연결을 끝내는 시도가 완료됐다는것을 알리기 위해 호출한다. 성공적으로 혹은 에러로. NdisCmCloseCallComplete의 호출은 NDIS가 클라이언트의 ProtocolClCloseCallComplete함수를 호출하도록 한다.

만약 Status로써 NDIS_STATUS_SUCCESS를 넘기면, 콜 매니저는 NdisVcHandle (그리고 NdisPartyHandle)을 NdisCmCloseCallComplete함수를 호출하자마자 네트웍 상으로의 전송에대해 사용할수 없도록 간주한다. 만약 콜 매니저가 처음에 VC를 만들었다면, NdisCmCloseCallComplete함수로 막 넘겨준 같은 NdisVcHandle로 NdisCoDeleteVc함수를 호출해야만 한다. 만약 클라이언트가 이 VC를 만든다면, 콜 매니저는 입력 파라미터로써 같은 NdisVcHandle을 가진ProtocolVcContext로 ProtocolCoDeleteVc함수의 호출을 기대할수있다.

그 자신들을 프로토콜로써 NDIS에게 등록 하는 단지 독립적인 콜 매니저만이 NdisCmCloseCallComplete함수를 호출 할수있다. 통합적인 콜 매니지먼트 지원을 제공하는 연결지향 NIC미니포트는 NdisMCmCloseCallComplete을 대신 호출한다.

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