NdisClModifyCallQoS (NDIS 5.1) function
Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
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
NdisVcHandle [in]
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 [in]
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 NIC 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
Target platform |
Universal |
Version |
See NdisClModifyCallQoS. |
Header |
Ndis.h (include Ndis.h) |
Library |
Ndis.lib |
IRQL |
<= DISPATCH_LEVEL |
See also
ProtocolClModifyCallQoSComplete