ProtocolClCloseCallComplete

VOID 

  ProtocolClCloseCallComplete(

    IN NDIS_STATUS  Status,

    IN NDIS_HANDLE  ProtocolVcContext,

    IN NDIS_HANDLE  ProtocolPartyContext  OPTIONAL

    );

모든 연결 지향 NDIS 클라이언트들은 그들이 NdisClCloseCall 함수로 초기화한 비동기 연산들을 완성하기 위해 ProtocolClCloseCallComplete 함수들을 가져야 한다.

매개변수

Status
다음과 같은 값들이 될 수 있는 이러한 호출을 닫기 위한 클라이언트 요구의 마지막 상태를 지정한다.

NDIS_STATUS_SUCCESS
콜 매니저는 주어진 VC에 존재하고 VC를 비활성화하는 호출을 성공적으로 닫는다.

NDIS_STATUS_XXX
콜 매니저는 몇몇 CM 결정 이유를 위한 호출을 닫기 위한 요구가 실패하고 NDIS는 클라이언트에 대한 ProtocolCmCloseCall에 의해 리턴된 상태를 전달한다.(propagated)

ProtocolVcContext
클라이언트의 VC당 컨텍스트 영역에 대한 핸들을 지정한다. 이것은 클라이언트가 NdisCoCreateVc 함수로 NDIS에게 전달하거나 ProtocolCoCreateVc 함수로 리턴한 핸들이다.

ProtocolPartyContext
멀티포인트 연결를 표시하는 클라이언트가 만든 VC에 대한 마지막 남아 있는 party를 위한 클라이언트의 party당 컨텍스트 영역에 대한 핸들을 지정한다. 그렇지 않으면, 이 매개변수는 NULL이다.

주석

만약 주어진 VC가 클라이언트에 의해 만들어지고 Status가 NDIS_STATUS_SUCCESS이면, 클라이언트는 다음과 같은 일들중 하나를 행한다:

  • NdisCoDeleteVc 함수로 VC를 끊고 할당한 컨텍스트 영역을 재사용을 위해 해제하거나 준비한다.

  • VC당 컨텍스트 영역을 재 초기화하고 NdisClMakeCall로 또하나의 연결을 하기 위해 VC를 재사용한다.

만약 VC가 콜 매니저에 의해 만들어지면, 클라이언트는 ProtocolClCloseCallComplete 함수가 호출될 때, NdisVcHandle은 유효하지 않다고 생각해야 한다. 클라이언트는 이러한 NdisVcHandle로 어떤 NdisCl/CoXxx 호출들을 하지 말아야 한다. ProtocolClCloseCallComplete 함수가 제어를 리턴한 후, 콜 매니저는 클라이언트의 ProtocolCoDeleteVc 함수에 대한 호출을 야기하는 VC를 지울 수 있다. 콜 매니저는 심지어 클라이언트의 ProtocolClIncomingCall 함수에 대한 호출을 야기하는 만들어진 VC에서 또하나의 들어오는 호출을 디스패치할 수 있다.

ProtocolClCloseCallComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.