NdisCmModifyCallQoSComplete function (ndis.h)

NdisCmModifyCallQoSComplete indicates the completion of the client's request, for which the call manager previously returned NDIS_STATUS_PENDING, to modify the quality of service on a VC.

Syntax

void NdisCmModifyCallQoSComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameters

[in] Status

Specifies the final status of the client's request to modify the QoS on this VC, either NDIS_STATUS_SUCCESS or any CM-determined NDIS_STATUS_ XXX except NDIS_STATUS_PENDING.

[in] NdisVcHandle

Specifies the handle to the VC, obtained from the CallMgrVcContext passed in to the CM's ProtocolCmModifyCallQoS function for this request.

[in] CallParameters

Pointer to a structure of type CO_CALL_PARAMETERS specifying a QoS acceptable to the call manager and underlying miniport driver if Status is set to NDIS_STATUS_SUCCESS.

Return value

None

Remarks

A call to NdisCmModifyCallQoSComplete causes NDIS to call the client's ProtocolClModifyCallQoSComplete function.

Because the CM can modify the client-supplied call parameters that were input to its ProtocolCmModifyCallQoS function before it calls NdisCmModifyCallQoSComplete, the client's ProtocolClModifyCallQoSComplete function examines the QoS to determine whether it is acceptable to the client. ProtocolClModifyCallQoSComplete simply returns control if the client accepts the given call parameters. Otherwise, the client tears down the call.

Only stand-alone call managers, which register themselves with NDIS as protocol drivers, can call NdisCmModifyCallQoSComplete. Connection-oriented miniport drivers that provide integrated call-management support call NdisMCmModifyCallQoSComplete instead.

Requirements

Requirement Value
Minimum supported client Supported for NDIS 6.0 and NDIS 5.1 drivers (see NdisCmModifyCallQoSComplete (NDIS 5.1)) in Windows Vista. Supported for NDIS 5.1 drivers (see NdisCmModifyCallQoSComplete (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_CallManager_Function(ndis)

See also

CO_CALL_PARAMETERS

NdisClModifyCallQoS

NdisMCmModifyCallQosComplete

ProtocolClModifyCallQoSComplete

ProtocolCmModifyCallQoS