NdisCmDispatchIncomingCallQoSChange 函数 (ndis.h)

项目
08/07/2023

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)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 符合性规则	Irql_CallManager_Function (ndis)