NdisClModifyCallQoS

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

NdisClModifyCallQoS함수는 연결에대한 서비스 질의 변화를 요청한다.

매개변수

NdisVcHandle

클라이언트가 QoS를 수정하기 원하는것에대한 VC의 핸들을 지정한다. 클라이언트는 원래 NdisCoCreateVc함수의 호출에 의해 이 핸들을 얻는다. 그리고 더 최근에 각 VC상태 영역으로 부터 이 핸들을 생성한다.

CallParameters

호출자에의해 요청된 새로운 QoS를 지정하는 CO_CALL_PARAMETERS타입의 구조체에대한 포인터.

리턴값

NdisClModifyCallQoS함수가 NDIS_STATUS_PENDING이외의 다른 어떤것을 리턴할때, 클라이언트는 ProtocolClModifyCallQoSComplete함수에대한 내부적인 호출을 한다. 그렇지 않으면, 이 연산이 완료될때 NDIS는 클라이언트의 ProtocolClModifyCallQoSComplete함수를 호출한다.

주석

NdisClModifyCallQoS의 호출은 NDIS가 CM의 ProtocolCmModifyCallQoS함수의 호출을 야기한다. 교대로 이것은 만약 요청된 QoS변화가 만들어 질수 있다면 하위 닉드라이버에게 콜 파라미터의 변화를 알리기위해 NdisCmActivateVc함수를 호출한다.

만약 콜 메니저가 클라이언트의 제안된 QoS변화를 받아들이지 않는다면, 클라이언트는 콜에대한 변화지 않는 QoS를 사용하는것을 계속 할수 있거나 호출을 해제할수있다. 만약 클라이언트와 콜 매니저가 특별한 호출에대한 QoS에 동의할수 없다면, VC의 생성자는 VC의 해제를 초기화하는것에 책임이 있다.

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