NdisCmDispatchIncomingCallQoSChange (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.
NdisCmDispatchIncomingCallQoSChange notifies a client that a request to change the quality of service on that client's active connection has been received over the network.
Syntax
VOID NdisCmDispatchIncomingCallQoSChange(
_In_ NDIS_HANDLE NdisVcHandle,
_In_ PCO_CALL_PARAMETERS CallParameters
);
Parameters
NdisVcHandle [in]
Specifies the handle to the VC for which the change in QoS is being requested. The call manager originally obtained this handle either when it called NdisCoCreateVc to set up this connection for an incoming call or as an input parameter to its ProtocolCoCreateVc function.CallParameters [in]
Pointer to a structure of type CO_CALL_PARAMETERS that specifies the new QoS, requested by the client on the remote node, for this connection.
Return value
None
Remarks
A stand-alone call manager calls NdisCmDispatchIncomingCallQoSChange to notify the client that it has received a request to modify the QoS on an active connection. Such a CM supports dynamic QoS changes on active calls, which is a feature like QoS itself that depends on the signaling protocol. For example, ATM networks do not support dynamic QoS changes on active connections.
When the CM itself receives a request for a QoS change, the call manager passes appropriately modified call parameters to NdisCmActivateVc, so the underlying NIC driver also is notified of the proposed QoS change. Assuming the underlying NIC driver accepts the changed call parameters, the CM then calls NdisCmDispatchIncomingCallQoSChange.
A call to NdisCmDispatchIncomingCallQoSChange causes NDIS to call the client's ProtocolClIncomingCallQosChange function. The client accepts the proposed modifications to the call parameters for the VC by doing nothing, except possibly updating any state it maintains about the QoS for the VC, and returning control. Otherwise, the client rejects the proposed QoS change by tearing down the call.
Only stand-alone call managers, which register themselves with NDIS as protocols, can call NdisCmDispatchIncomingCallQoSChange. Connection-oriented miniport drivers that provide integrated call-management support call NdisMCmDispatchIncomingCallQoSChange instead.
Requirements
Target platform |
Universal |
Version |
|
Header |
Ndis.h (include Ndis.h) |
Library |
Ndis.lib |
IRQL |
<= DISPATCH_LEVEL |
See also
NdisMCmDispatchIncomingCallQoSChange
ProtocolClIncomingCallQosChange