NdisCmDispatchIncomingCallQoSChange

VOID NdisCmDispatchIncomingCallQoSChange( IN NDIS_HANDLE NdisVcHandle, IN PCO_CALL_PARAMETERS CallParameters );

NdisCmDispatchIncomingCallQoSChange함수는 클라이언트에게 그 클라이언트의 활성연결이 네트웍 상으로 받아지는 QoS의 변화에대한 요청을 알린다.

매개변수

NdisVcHandle

QoS내의 변화가 요구되어지고 있다는것에대한 VC의 핸들을 지정한다. 콜 매니저는 들어오는 호출에대해 이연결을 설정하기위해 NdisCoCreateVc함수를 호출했을때 혹은 ProtocolCoCreateVc함수의 입력 파라미터 값으로 처음에 이핸들을 얻는다.

CallParameters

이 연결에 대해서 리모트 노드의 클라이언트에 의해 요구된 새로운 QoS를 지정하는 CO_CALL_PARAMETERS타입의 구조체 포인터.

주석

독립적인 콜 매니저는 활성화 연결의 QoS를 수정하기위한 요청을 받은것을 클라이언트에게 알리기위해 NdisCmDispatchIncomingCallQoSChange함수를 호출한다. 그런 CM은 활성화 콜들에대해 동적QoS변화를 지원한다. 이것은 시그널링 프로토콜에 의존한느 스스로의 QoS와 같은 특징이다. 예를들어, ATM네트웍은 활성화 연결에대해 동적 QoS변화를 지원하지 않는다.

CM이 QoS변화에 대한 요청을 받았을때, 콜 매니저는 적절히 수정된 콜 파라미터를 NdisCmActivateVc함수에게 넘긴다. 그래서 하위 닉 드라이버는 또한 제출된 QoS변화를 받는다. 하위 닉 드라이버가 변화된 콜 파라미터들을 받아들인다고 가정하면, CM은 이제 NdisCmDispatchIncomingCallQosChange함수를 호출한다.

NdisCmDispatchIncomingCallQosChange함수의 호출은 NDIS로 하여금 클라이언트의 ProtocolClIncomingQoSChange함수의 호출을 야기시킨다. 클라이언트는 VC에대한 QoS에대하여 유지하는 가능한 어떤 상태 업데이트를 제외한 어떠한 것도 행함없이, 그리고 컨추럴을 리턴하면서 제안된 수정본을 VC에대한 콜 파라미터들로 받아들인다. 그렇지 않으면, 클라이언트는 콜을 해제하는것에의해 제안된 QoS변화를 거절한다.

단지 스스로 NDIS에의해 프로토콜로써 등록하는 독립적인 콜 매지저만이 NdisCmDispatchIncomingCallQoSChange함수를 호출할수 있다. 통합 콜 매니지먼트를 지원하는 연결지향 닉 미니포트들은 NdisMCmDispatchIncomingCallQoSChange함수를 대신 호출한다.

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