NdisClModifyCallQoS function

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 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

Target platform

Version

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.

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

 

 

Send comments about this topic to Microsoft

Show: