NdisCmActivateVc

NDIS_STATUS 

  NdisCmActivateVc(

    IN NDIS_HANDLE  NdisVcHandle,

    IN OUT PCO_CALL_PARAMETERS  CallParameters

    );

NdisCmActivateVc는 특별한 VC에대한 미디어 파라미터들을 포함하는 CM제공 콜 파라미터들을 하위 닉 드라이버에게 보낸다.

매개변수

NdisVcHandle
콜 파라미터들을 설정하는 VC를 확인 하는 핸들을 지정한다. 콜 매니저는 들어오는 호출에대한 NdisCoCreateVc로부터 이 핸들을 얻거나 혹은 클라이언트가 초기화한 나가는 호출에대한 ProtocolCoCreateVc함수에게 입력 파라미터로써 얻는다.

CallParameters
CM할당 상주 버퍼의 포인터, CO_CALL_PARAMETERS타입 구조체로써 포맷된, 하위 미니포트가 VC활성화를 위해 사용하는 모든 미디어 특정 파라미터들을 포함하는.

리턴값

NdisCmActivateVc함수가 NDIS_STATUS_PENDING이외의 다른 것을 리턴할때, 콜 매니저는 ProtocolCmActivateVcComplete함수의 내부적인 호출을 해야만한다. 그렇지않으면, NDIS는 이 연산이 완료됐을때 CM의 ProtocolCmActivateVcComplete함수를 호출한다.

주석

NdisCmActivateVc함수는 하위 닉 드라이버에게 새롭게 만들어진 VC에대한 호출과 미디어 파라미터와 호출을 설정하는것 혹은 성립된 VC의 이러한 변화를 알린다. NDIS는 주어진 콜 파라미터들과 VC핸들을 하위 닉 드라이버의 MiniportCoActivateVc함수에게 포워드 한다. 이것은 VC의 상태를 트랙하기위한 모든 필요한 리소스들을 설정하고 스스로 만들고 VC에대한 데이타 전송을 위한 닉 준비를 설정한다.

VC에대한 연결을 설정한후에 그렇지만 어떤 데이타가 VC로 보내지거나 받아지기 전에 독자적인 조작이 가능한 CM은 항상 NdisCmActivateVc함수를 호출한다. 연결되어 있는동안에대해, CM은 네트웍 변화에대한 상태 그리고/혹은 클라이언트가 NdisClModifyCallQoS함수를 호출할때마다 같은NdisVcHandle로 NdisCmActivateVc함수를 자주 호출한다. 각각의 그런 NdisCmActivateVc함수의 호출에서, 하위 닉 드라이버의 MiniportCoActivateVc함수는 다음중 하나를 해야만 한다.:

  • 만약 미니포트가 새롭게 수정된 콜 파라미터들에따른 VC로의 전송들을 이루는것을 계속할수 있다면, 닉 드라이버가 콜 매니저에의해 제공한 새로운 값에대한 콜 파라미터들에대해 유지하는 상태를 업데이트한다.

  • 만약 닉 드라이버가 주어진 콜 파라미터의 제약하에 전송을 이루는것을 계속할 수 없다면 호출은 실패이다.

하위미니포트가 콜 파라미터들의 설정과 재설정 요청이 실패할때, 콜 매니저는 CallParameters의 원래 특성은 수정할것이고 NdisCmActivateVc함수를 다시 호출한다. 어떤 콜매니저가 VC를 활성화 하려는 시도의 많은 반복에대한 제한은 구현에 의존한다.

NDIS에게 NdisCmMakeCallComplete으로 나가는 호출을 알리기전에, 클라이언트가 초기화한 나가는 호출에대해, 독립적인 CM은 일반적으로 호출의 리모트 타겟과 스위치의 콜 셋업으로 협상된 동의를 확인하는 패킷 교환을 이으면서 NdisCmActivateVc함수를 즉시 호출한다. 들어오는 호출에대해, NdisCoCreateVc함수의 성공적인 호출후 그리고 NdisCmDispatchIncomingCall함수의 호출전에 콜 매니저는 일반적으로 NdisCmActivateVc함수를 호출한다.

나가는 호출의 설정과정에서 그리고 어떤 VC가 활성화 상태로 남아있는 동안, 클라이언트는 VC에대한 콜 파라미터에대한 변화를 요청할수있다. 예를들어, NdisClModifyCallQos의 호출에의해. 어떤 그런 요청에대해 주어진 콜 파라미터의 유효를 수정한후, 독립적인 콜 매니저는 수정된 콜 파라미터를 하위 미니포트에게 보내기위해 NdisCmActivateVc함수를 호출해야만한다.

NDIS로 프로토콜에게 스스로 등록 할수있는 단지 독립적인 콜 매니저만이 NdisCmActivateVc함수를 호출할수 있다. 통합된 콜 매니저 지원을 제공하는 연결지향 닉 미니포트는 NdisMCmActivateVc함수를 대신 호출한다.

NdisCmActivateVc의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될수있다.