ProtocolCmDeactivateVcComplete

VOID ProtocolCmDeactivateVcComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE CallMgrVcContext );

ProtocolCmDeactivateVcComplete 함수는 아래 미니포트 (그리고 NDIS) 가 NdisCmDeactivateVc 함수가 전에 NDIS_STATUS_PENDING을 리턴한 아래 미니포트가 VC를 비활성화하는 콜 매니저 초기화된 요구의 처리를 완성하는데 필요한 함수이다.

매개변수

Status

비활성화의 마지막 상태를 지정한다.

CallMgrVcContext

콜 매니저가 VC당 상태를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 콜 매니저는 ProtocolCoCreateVc 함수로부터 NDIS에게 이 핸들을 제공한다.

주석

NDIS는 항상 연결 지향 클라이언트를 위해 호출을 콜 매니저의 호출을 끊는 컨텍스트내에서 ProtocolCmDeactivateVcComplete 함수를 호출한다. 콜 매니저는 일반적으로 ProtocolCmCloseCall 함수로부터 NdisCmDeactivateVc 함수를 호출한다. NdisCmDeactivateVc 함수가 NDIS_STATUS_PENDING을 리턴할 때마다, NDIS는 계속해서 ProtocolCmDeactivateVcComplete 함수를 호출한다.

즉, 아래 연결 지향 미니포트가 VC를 비활성화할 때, NDIS는 ProtocolCmDeactivateVcComplete 함수를 호출한다. 비활성화의 마지막 상태는 Status값에서 발견된다. 마지막 상태을 위한 가능한 값들은 제한은 되지 않지만은 다음과 같은 값이다:

NDIS_STATUS_SUCCESS

VC가 성공적으로 비활성화되었다는 것을 가리킨다.

NDIS_STATUS_NOT_ACCEPTED

활성화가 이 VC에서 연재 지연되고 있다는 것을 가리킨다. 콜 매니저는 나중에 VC를 비활성화 시도를 해야 한다.

NDIS_STATUS_CLOSING

비활성화는 현재 이 VC에서 지연되고 있다고 가리킨다. 콜 매니저는 NdisCmDeactivateVc에 대한 단지 하나의 호출에서 VC를 비활성화시키기 위해 필요로되어지는 것처럼 다시 NdisCmDeactivateVc 함수를 호출할 필요가 없다.

ProtocolCmDeactivateVcComplete 함수는 전처리가 연결이 비활성화되거나 혹은 VC가 활성화있는 동안 사용된 할당된 자원들을 동적으로 해제하는것을 가리키기 위해 상태 영역에 플래그들을 설정하는 것과 같은 가상 연결의 비활성화를 완성하기 위해 필요한 것들을 행한다.

비활성화의 완성이 활성을 위해 사용된 VC를 위한 모든 콜 매개변수들이 더 이상 유효하지 않다는 것을 의미한다. 어떤 VC의 계속된 사용은 새로운 콜 매개변수들의 서렁으로 그것을 재활성화하는 것을 제외해 금지되었다.

콜 매개변수들은 VC 활성화를 위해 할당된 어떤 자원들을 해제해야 하고 가능한한 빠르게 제어를 리턴해야 한다. 만약 콜 매니저가 전에 ProtocolCmCloseCall 함수로부터 NDIS_STATUS_PENDING 을 리턴하고 호출을 닫는 모든 연산들이 완성된다면, ProtocolCmDeactivateVcComplete 함수는 지금 NdisCmCloseCallComplete 함수를 호출해야 한다.

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