NdisMCmCloseCallComplete
VOID
NdisMCmCloseCallComplete(
IN NDIS_STATUS Status,
IN NDIS_HANDLE NdisVcHandle,
IN NDIS_HANDLE NdisPartyHandle OPTIONAL
);
|
NdisMCmCloseCallComplete함수는 MCM드라이버가 콜을 해제하기위해 NDIS_STATUS_PENDING을 리턴한것에대한 클라이언트의 최종 상태를 리턴한다.
매개변수
- Status
- MCM미니포트가 연결을 종료하는 클라이언트의 요청의 최종상태를 지정한다. NDIS_STATUS_SUCCESS혹은 NDIS_STATUS_PENDING을 제외한 호출자 의존 NDIS_STATUS_XXX.
- NdisVcHandle
- 호출에대해 VC에대한 핸들을 지정한다. 이 핸들은 VC가 처음에 NdisMCmCreateVc함수로 MCM드라이버에의해서 혹은 ProtocolCoCreateVc함수에대한 입력 파라미터로써 만들어졌을때, NDIS에의해 제공된다.
- NdisPartyHandle
- 만약 NdisVcHandle이 포인트-포인트VC를 나타낸다면 혹은 MCM드라이버는 입력 파라미터로써 ProtocolCmCloseCall함수에게 넘겨지는 CallMgrPartyContext에의해 만들어진 파티당 상태로부터 얻는 멀티포인트 연결에서의 마지막으로 남아있는 파티에대한 핸들을 지정한다면, NULL을 지정한다.
주석
만약 MCM미니포트의 ProtocolCmCloseCall함수가 NDIS_STATUS_PENDING을 리턴한다면, 클라이언트와 NDIS에게 연결해제에 대한 시도가 성공적인지 아닌면 에러를 가지고 있는지 완료됐다는것을 알리기위해 NdisMCmCloseCallComplete함수를 호출해야만 한다. NdisMCmCloseCallComplete함수에대한 호출은 NDIS로하여금 클라이언트의 ProtocolClCloseCallComplete함수를 호출하도록 한다.
만약 Status에 NDIS_STATUS_SUCCESS를 넘겼다면, MCM드라이버는 NdisVcHandle(NdisPartyHandle마저)이 NdisMCmCloseCallComplete함수를 호출 하자마자 네트웍상으로 전송을 사용할수 없다고 간주한다. 만약 MCM미니포트가 처음에 VC를 만들었다면, NdisMCmCloseCallComplete함수에게 막 넘긴 같은 NdisVcHandle로 NdisMCmDeleteVc함수를 호출해야만 한다. 만약 클라이언트가 이 VC를 만든다면, MCM드라이버는 입력 파라미터로써 같은 NdisVcHandle을 저장한것에서의 VC당 상태를 만드는 ProtocolVcContext로 ProtocolCoDeleteVc함수를 호출 할수 있다고 생각한다.
단지 통합 콜 매니지먼트지원을 제공하는 연결지향 닉 미니포트들만이 NdisMCmCloseCallComplete함수를 호출할 수 있다. 스스로를 NDIS에게 프로토콜로써 등록할수 있는 독립적인 콜 매니저들은 대신 NdisCmCloseCallComplete함수를 호출한다.
NdisMCmCloseCallComplete함수의 호출은 IRQL <= DISPATCH_LEVEL에서 동작 될수 있다.
|