NdisClModifyCallQoS function (ndis.h)
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) |