NdisMCmDispatchIncomingCallQoSChange macro (ndis.h)

NdisMCmDispatchIncomingCallQoSChange 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 NdisMCmDispatchIncomingCallQoSChange(
   _H_,
   _P_
);

Parameters

_H_

Specifies the handle to the VC for which the change in QoS is being requested. The MCM driver obtained this handle either when it called NdisMCmCreateVc to set up this connection for an incoming call or as an input parameter to its ProtocolCoCreateVc function.

_P_

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

An MCM driver calls NdisMCmDispatchIncomingCallQoSChange to notify the client that it has received a request to modify the QoS on an active connection. Such an MCM driver supports dynamic QoS changes on active calls, which is a feature like QoS itself that depends on the signaling protocol.

The MCM driver should call NdisMCmActivateVc whenever it makes changes in the call parameters for an active VC.

A call to NdisMCmDispatchIncomingCallQoSChange causes NDIS to call the client's ProtocolClIncomingQoSChange 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 connection-oriented miniport drivers that provide integrated call-management support can call NdisMCmDispatchIncomingCallQoSChange. Stand-alone call managers, which register themselves with NDIS as protocol drivers, call NdisCmDispatchIncomingCallQoSChange instead.

Requirements

See also

CO_CALL_PARAMETERS

NdisClCloseCall

NdisClModifyCallQoS

NdisMCmActivateVc

NdisMCmCreateVc

ProtocolCoCreateVc