NdisMCmActivateVc

NDIS_STATUS NdisMCmActivateVc( IN NDIS_HANDLE NdisVcHandle, IN PCO_CALL_PARAMETERS CallParameters );

NdisMCmActivateVc함수는 NDIS에게 MCM미니포트가 지정된 VC로 전송을 만들 준비가 됐다는 것을 알린다.

매개변수

NdisVcHandle

VC를 확인하는 핸들을 지정한다.

CallParameters

미니포트가 활서화된 VC에대해 사용하는 모든 미디어지정 파라미터들을 포함하는 호출자 할당 버퍼의 포인터, CO_CALL_PARAMETERS타입의 구조체로써 포맷된,

리턴값

NdisMCmActivateVc함수는 NDIS_STATUS_PENDING이외의 다른것을 리턴하고, MCM드라이버는 ProtocolCmActivateVcComplete함수의 내부적인 호출을 만들어야만 한다. 그렇지 않으면, NDIS는 이 연산이 완료될때, MCM 미니포트의 ProtocolCmActivateVcComplete함수를 호출한다.

주석

NdisMCmActivateVc함수는 NDIS에게 MCM드라이버가 호출과 새롭게 생성된 VC혹은 성립된 VC에 변화된 콜 파라미터를 설정한다는것을 알린다.

MCM드라이버는 VC에 연결을 성립한후 하지만 그 VC로 데이타를 보내거나 받기전에 NdisMCmActivateVc함수를 호출해야만 한다. 이 호출은 NDIS에게 미니포트가 그 VC로 전송을 할 태세로 닉을 만들었다는것을 알린다.

클라이언트가 초기화하는 나가는 호출에대해, NdisMCmMakeCallComplete함수로 NDIS(클라이언트)에게 나가는 호출의 완료를 알리기전에 MCM드라이버는 일반적으로 리모트 노드와 혹은 스위치에서 성공적인 콜-설정과 협상된 동의를 표시하는 핸드쉐이크를 따르는 NdisMCmActivateVc함수를 호출한다. 들어오는 호출에대해, MCM드라이버는 일반적으로 NdisMCmCreateVc함수를 성공적으로 호출한후 그리고 NdisMCmDispatchIncomingCall함수를 호출하기전에 NdisMCmActivateVc함수를 호출한다.

드라이버 개발자는 MCM미니포트가 나가고 들어오는 호출에대해 연결을 설정하는 컨텍스트내에서 드라이버가 호출하는 (내부적인)MiniportCoActivateVc함수를 가지고 있는지를 결정한다.

연결된 동안에, MCM미니포트는 콜파라미터들을 네트웍 변화에 상태로써 수정하고/혹은 클라이언트가 NdisClModifyCallQoS함수를 호출할때마다. MCM드라이버는 만약 새롭게 수정된 콜 파라미터들에따른 VC에대한 전송을 만들기위해 계속할수 있다면, 새로운 값들에대한 콜 파라미터들에대해 유지하는 상태를 업데이트 해야만 한다. NDIS에게 활성화된 VC에대한 콜 파라미터내의 어떤 변화들을 알리기위해 NdisMCmActivateVc함수를 호출해야만 한다. 그렇지 않으면, MCM드라이버는 다음중 하는를 할수 있다.:

• 닉 드라이버가 그VC에대해 전송을 만드는것을 계속할수 없다는 상태의 VC에대한 콜 파라미터혹은 QoS를 수정하기위한 클라이언트의 요청이 실패한후 NdisMCmDeactivateVc함수를 호출하라.
• 전에 받아들여진 상태에대한 콜 파라미터를 저장하라,클라이언트에게 요청된 변화를 알려라, 그리고 그VC에서의 데이타 전송을 계속할 준비가 된 상태로 유지하라.

NdisMCmActivateVc함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작되어질수 있다.