ProtocolCmModifyCallQoS

NDIS_STATUS ProtocolCmModifyCallQoS( IN NDIS_HANDLE CallMgrVcContext, IN CO_CALL_PARAMETERS CallParameters );

ProtocolCmModifyCallQoS 함수는 연결 지향 클라이언트가 콜 매니저들이 존재하는 가상 연결(VC)을 위해 변화되는 것을 요구할 때 NDIS에 의해 호출되는 필요한 함수이다. 만약 아래 네트워크 미디엄이 QoS를 지원하지 않는다면, ProtocolCmModifyCallQoS 함수는 단지 NDIS_STATUS_NOT_SUPPORTED를 리턴해야 한다.

매개변수

CallMgrVcContext

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

CallParameters

VC를 위한 연결 지향 클라이언트에 의해 지정된 새로운 콜 매개변수들을 포함하는 CO_CALL_PARAMETERS를 가리킨다.

리턴값

ProtocolCmModifyQoS 함수는 다음과 같은 값들 중 하나인 연산들의 상태를 리턴한다. :

NDIS_STATUS_SUCCESS

콜 매니저는 성공적으로 CallParameters에 지정된 콜 매개변수들로 네트워크에 호출의 매개변수들을 바꿨다는 것을 가리킨다.

NDIS_STATUS_PENDING

콜 매니저가 비동기적으로 콜 매개변수들을 수정하기 위한 요구를 완성할 것이라는 것을 가리킨다. 콜 매니저가 콜 매개변수들을 수정하기 위해 필요한 모든 연산들을 완성했을 때, NdisCmModifyCallQoSComplete 함수를 호출해야 한다.

NDIS_STATUS_RESOURCES

콜 매니저는 동적으로 할당된 자원들이 이용할 수 없기 때문에 VC의 콜 매개변수들을 바꿀 수 없다는 것을 가리킨다.

NDIS_STATUS_INVALID_DATA

콜 매니저는 CallParameters에 제공된 콜 매개변수들이 불법이거나 유효하지 않기 때문에 VC의 콜 매개변수들을 바꿀 수 없다는 것을 가리킨다.

NDIS_STATUS_FAILURE

콜 매개변수들이 네트워크의 실패 혹은 또 하나의 연결 지향 네트워크 컴포넌트의 실패때문에 제공된 콜 매개변수들이 설정될 수 없다는 것을 가리킨다.

주석

ProtocolCmModifyQoS는 설립된 가상 연결을 위해 미디어 특정 콜 매개변수들을 수정하기 위해 미디어에 의해 필요한 것처럼 네트워크 제어 장치들 혹은 다른 미디어 특정 에이전트들과 통신한다. 만약 콜 매니저가 네트워크 제어 에이전트들과 통신하기 위해 필요로 되어진다면,(네트워크 스위치) ProtocolBindAdapter 함수에서 설립된 네트워크 제어 에이전트와의 가상 연결을 사용해야 한다. 혼자인 콜 매니저들은 NdisCoSendPackets 함수를 호출함으로써 네트워크 에이전트들과 통신한다. 통합된 호출 관리 지원을 하는 NIC 미니포트들은 결코 NdisCoSendPackets 함수들을 호출하지 않는다. 그 대신에, 그러한 드라이버는 간단히 타켓 네트워크 에이전트로 네트워크을 걸쳐 데이터를 전송한다.

네트워크와 통신한 후 만약 변화들이 성공적이면, 콜 매니저는 새로운 콜 매개변수들로 NdisCmActivateVc 함수를 호출해야 한다. 이것은 콜 매개변수들이 이러한 매개변수들을 유효화하기 위한 기회를 미니포트에게 제공하고 바뀐다는 것을 NDIS 혹은 연결 지향 미니포트에 알린다.

만약 네트워크이 새로운 콜 매개변수들을 허락할 수 없거나 아래 미니포트가 매개변수들을 수락할 수 없다면, 콜 매니저는 어떤 수정이 시도되기 전에 존재한 상태로 가상 연결을 회복해야 하고 NDIS_STATUS_FAILURE를 리턴한다.

ProtocolCmModifyQoSComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.