NdisClModifyCallQoS function

NdisClModifyCallQoS requests a change in the quality of service on a connection.

Syntax

NDIS_STATUS NdisClModifyCallQoS(
  NDIS_HANDLE         NdisVcHandle,
  PCO_CALL_PARAMETERS CallParameters
);

Parameters

NdisVcHandle

Specifies the handle to the VC for which the client wants to modify the QoS. The client originally obtained this handle by calling NdisCoCreateVc, and, more recently, retrieved this handle from its per-VC state area.

CallParameters

Pointer to a structure of type CO_CALL_PARAMETERS that specifies the new QoS requested by the caller.

Return Value

When NdisClModifyCallQoS returns anything other than NDIS_STATUS_PENDING, the client should make an internal call to its ProtocolClModifyCallQoSComplete function. Otherwise, NDIS calls the client's ProtocolClModifyCallQoSComplete function when this operation is completed.

Remarks

A call to NdisClModifyCallQoS causes NDIS to call the CM's ProtocolCmModifyCallQoS function, which, in turn, calls NdisCmActivateVc to notify the underlying miniport driver to change the call parameters if the requested QoS change can be made.

If the call manager does not accept the client's proposed QoS change, the client either can continue using the unchanged QoS for the call or can tear down the call. If the client and call manager cannot agree on the QoS for a particular call, the creator of the VC is responsible for initiating the teardown of the VC.

Requirements

   
Minimum supported client Supported for NDIS 6.0 and NDIS 5.1 drivers (see NdisClModifyCallQoS (NDIS 5.1)) in Windows Vista. Supported for NDIS 5.1 drivers (see NdisClModifyCallQoS (NDIS 5.1)) in Windows XP.
Target Platform Desktop
Header ndis.h (include Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI compliance rules Irql_Protocol_Driver_Function

See Also

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisClCloseCall

NdisCmModifyCallQoSComplete

NdisCoCreateVc

ProtocolClModifyCallQoSComplete

ProtocolCmModifyCallQoS