NdisClModifyCallQoS function (ndis.h)

Article
04/18/2022

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

Syntax

NDIS_STATUS NdisClModifyCallQoS(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameters

[in] 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.

[in] 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

Requirement	Value
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(ndis)