ProtocolClModifyCallQoSComplete

VOID ProtocolClModifyCallQoSComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE ProtocolVcContext, IN PCO_CALL_PARAMETERS CallParameters );

연결에서 QoS를 수정할 수 있는 연결 지향 NDIS 클라이언트들은 동적으로 그들이 NdisClModifyCallQoS 함수로 초기화하는 비동기 연산들을 완성하기 위해 ProtocolClModifyCallQoSComplete 함수들을 가져야 한다. 그렇지 않으면, 그러한 프로토콜 드라이버의 등록된 ProtocolClModifyCallQoSComplete 함수는 간단히 제어를 리턴한다.

매개변수

Status

다음과 같은 값들 중 하나로서 이러한 VC를 위한 콜 매개변수들을 수정하기 위한 클라이언트의 비동기 요구의 마지막 상태를 지정한다.

NDIS_STAUS_SUCCESS

QoS가 클라이언트에 의해 요구된 것으로 수정된다.

NDIS_STATUS_RESOURCES

NDIS 혹은 콜 매니저는 그들 중 하나가 동적으로 충분한 자원들을 할당할 수 없기 때문에 QoS를 수정할 수 없다.

NDIS_STATUS_INVALID_DATA

클라이언트가 NdisClModifyCallQoS에 제공된 콜 매개변수들이 유효하지 않다.

NDIS_STATUS_FAILURE

콜 매니저는 네트워크 혹은 또 하나의 연결 지향 네트워크 컴포넌트에서 실패때문에 QoS를 바꿀 수 없다.

NDIS_STATUS_XXX

콜 매니저는 QoS를 바꾸는 것을 실패했고, NDIS는 CM-결정 실패 상태를 클라이언트에게 전달한다.

ProtocolVcContext

클라이언트가 원래 만약 클라이언트가 이러한 VC에서 들어오는 호출을 수락한다면 ProtocolCoCreateVc 함수로부터 혹은 나가는 호출 요구를 설정하기 위해 NdisCoCreateVc 함수를 호출할 때 NDIS에게 제공하는 클라이언트의 VC당 컨텍스트 영역에 대한 핸들을 지정한다.

CallParameters

요구한 클라이언트 특정 QoS 변화 혹은 가능하면 콜 매니저가 회족한 연결이 활성화될 때 설립된 이러한 VC를 위해 QOS를 포함하는 버퍼화된 CO_CALL_PARAMETERS 구조체를 가리킨다.

주석

ProtocolClModifyCallQoSComplete 함수에 대한 호출은 콜 매니저가 활성화 VC에서 QoS를 바꾸기 위한 클라이언트 초기 요구를 처리를 완성하는 다는 것을 가리킨다. 예를 들어, 만약 아래 네트워크 미디엄이 동적 QoS 변화들을 지원한다면, 클라이언트는 활성화 VC에서 어떤 시간에도 수정을 요구할 수 있다.

만약 NdisClModifyCallQoS 함수에 대한 클라이언트의 호출이 성공이라면, ProtocolClModifyCallQoSComplete함수는 간단히 제어를 리턴함으로써 QoS 변화를 수락할 수 있다. 그렇지 않으면, ProtocolClModifyCallQoSComplete 함수는 클라이언트의 개발자가 많은 가능한 재협상들에 대한 몇몇 이유있는 제한들을 놓는한 콜 매니저와 further 협상을 할 수 있다. 대체적으로, ProtocolClModifyCallQoSComplete 함수는 간단히 콜 매니저가 QoS를 바꾸는 요구를 거절할 때 전에 설립된 QoS가 클라이언트에게 수락될 수 없을 때마다 NdisClCloseCall 함수로 호출을 끊을 수 있다.

ProtocolClModifyCallQoSComplete 함수는 IRQL DISPATCH_LEVEL로 실행할 수 있도록 쓰여져야 한다.