NdisCmDispatchIncomingCallQoSChange 函数 (ndis.h)
NdisCmDispatchIncomingCallQoSChange 通知客户端请求更改该客户端的活动连接上的服务质量。
语法
void NdisCmDispatchIncomingCallQoSChange(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
参数
[in] NdisVcHandle
指定要为其请求 QoS 更改的 VC 的句柄。 调用管理器最初在调用 NdisCoCreateVc 时获取此句柄,以便为传入调用设置此连接,或者将其 ProtocolCoCreateVc 函数的输入参数设置为此连接。
[in] CallParameters
指向 CO_CALL_PARAMETERS 类型的结构的指针,该结构指定远程节点上客户端为此连接请求的新 QoS。
返回值
没有
言论
独立调用管理器调用 NdisCmDispatchIncomingCallQoSChange,以通知客户端已收到修改活动连接上的 QoS 的请求。 此类 CM 支持对活动调用进行动态 QoS 更改,这是一项功能,如依赖于信号协议的 QoS 本身。
当 CM 本身收到 QoS 更改请求时,调用管理器会将经过适当修改的调用参数传递给 NdisCmActivateVc,因此基础微型端口驱动程序也会收到建议的 QoS 更改的通知。 假设基础微型端口驱动程序接受更改的调用参数,则 CM 将调用 NdisCmDispatchIncomingCallQoSChange。
调用 NdisCmDispatchIncomingCallQoSChange 会导致 NDIS 调用客户端的 ProtocolClIncomingQoSChange 函数。 客户端通过不执行任何作来接受对 VC 的调用参数的建议修改,只不过更新它维护的关于 VC 的 QoS 的任何状态,以及返回控件。 否则,客户端通过拆毁调用来拒绝建议的 QoS 更改。
只有将自己注册为协议驱动程序的 NDIS 的独立呼叫管理器才能调用 NdisCmDispatchIncomingCallQoSChange。 提供集成呼叫管理支持呼叫的连接微型端口驱动程序 NdisMCmDispatchIncomingCallQoSChange。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 Windows Vista 中的 NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)。 支持 NDIS 5.1 驱动程序(请参阅 Windows XP 中的 NdisCmDispatchIncomingCallQoSChange (NDIS 5.1) 。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
库 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_CallManager_Function(ndis) |