ProtocolCmActivateVcComplete

VOID ProtocolCmActivateVcComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE CallMgrVcContext, IN CO_CALL_PARAMETERS CallParameters );

ProtocolCmActivateVcComplete 함수는 NdisCoActivateVc에 대한 전 호출이 미니포트에 의해 완성됐다는 것을 콜 매니저에게 가리키는 필요한 함수이다.

매개변수

Status

VC를 활성화하기 위한 콜 매니저에 의한 요구의 미니포트에 의해 지시되는 것처럼 마지막 상태를 지정한다.

CallMgrVcContext

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

CallParameters

NdisCmActivateVc에 대한 호출로 콜 매니저에 의해 지정된 것처럼 콜 매개변수들을 가리킨다.

주석

다른 네트워크 컴포넌트들이 콜 매니저가 NdisCmActivateVc 함수를 호출할 때 초기화한 가상 연결을 위한 그들의 연산들을 초기화할 때, NDIS는 VC가 ProtocolCmActivateVcComplete 함수를 호출함으로써 활성화했다는 것을 콜 매니저에게 주지한다. 활성화의 상태는 Status에 발견된다. Status의 가능한 값들은 다음과 같이 포함되지만 제한되지 않는다:

NDIS_STATUS_SUCCESS

VC가 성공적으로 완성했고 콜 매니저는 미디어에 의해 요구된 것처럼 이러한 VC에서 연산들을 계속할 수 있다는 것을 가리킨다.

NDIS_STATUS_RESOURCES

활성화에서 또 하나의 컴포넌트는 메모리 부족 혹은 또하나의 타입의 자원을 할당할 수 없기 때문에 가상 연결을 활성하는데 실패했다는 것을 가리킨다.

NDIS_STATUS_NOT_ACCEPTED

비활성화는 VC에서 지연되고 VC는 더 이상 비활성화가 완성되고 성공적인 활성화가 일어날 때까지 네트워크 통신을 이용할 수 없다는 것을 가리킨다.

NDIS_STATUS_INVALID_DATA

미니포트가 어댑터에 대해 유효하지 않는 것처럼 CallParameters의 콜 매개변수들이 거절됐다는 것을 가리킨다.

ProtocolCmActivateVcComplete 함수는 가상 연결이 성공적으로 활성화됐다는 것을 확실히 하기 위해 Status로 리턴된 상태를 체크해야 한다. 콜 매니저는 만약 Status가 NDIS_STATUS_SUCCESS가 아니면, 가상 연결을 걸쳐 통신하는 시도를 할 필요가 없다.

콜 매니저는 가상 연결이 NDIS에게 제어를 리턴하기 전에 데이터 전송을 위한 준비를 하는 것을 확실히 하기 위해 그들의 네트워크 미디어에 의해 요구된 어떤 처리를 완성해야 한다.

만약 콜 매니저가 CallParameters->MediaParameters->Flags에서 ROUND_UP_FLOW 혹은 ROUND_DOWN_FLOW로 지정된다면, CallParameters로 리턴된 콜 매개변수들은 미니포트에 의해 변할 수 있다. 콜 매니저들은 적당한 연산을 확실히 하기 위해 리턴된 콜 매개변수들을 조사해야 한다. 만약 새로운 콜 매개변수들이 불만족스러우면, 콜 매니저는 NdisCmDeactivateVc 함수로 VC를 비활성화시키거나 혹은 새로운 콜 매개변수들로 다시 NdisCmActivateVc 함수를 호출해야 한다.

ProtocolCmActivateVcComplete 함수는 IRQL DISPATCH_LEVEL로 실행할 수 있도록 쓰여져야 한다.