NdisClModifyCallQoS 函数 (ndis.h)

NdisClModifyCallQoS 请求在连接上更改服务质量。

语法

NDIS_STATUS NdisClModifyCallQoS(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

参数

[in] NdisVcHandle

指定客户端要为其修改 QoS 的 VC 的句柄。 客户端最初通过调用 NdisCoCreateVc获取此句柄,并且最近从其每个 VC 状态区域中检索此句柄。

[in] CallParameters

指向CO_CALL_PARAMETERS类型的结构的指针,该结构指定调用方请求的新 QoS。

返回值

NdisClModifyCallQoS 返回除NDIS_STATUS_PENDING以外的任何内容时,客户端应对其进行内部调用 ProtocolClModifyCallQoSComplete 函数。 否则,NDIS 会在此作完成后调用客户端的 ProtocolClModifyCallQoSComplete 函数。

言论

调用 NdisClModifyCallQoS 会导致 NDIS 调用 CM 的 ProtocolCmModifyCallQoS 函数,后者反过来又调用 NdisCmActivateVc,以在发出请求的 QoS 更改时通知基础微型端口驱动程序更改调用参数。

如果调用管理器不接受客户端建议的 QoS 更改,客户端可以继续使用未更改的 QoS 进行调用,也可以拆毁呼叫。 如果客户端和呼叫管理器无法就 QoS 达成特定调用,则 VC 的创建者负责启动 VC 的拆解。

要求

要求 价值
最低支持的客户端 Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisClModifyCallQoS (NDIS 5.1)。 支持 NDIS 5.1 驱动程序(请参阅 Windows XP 中的 NdisClModifyCallQoS (NDIS 5.1)。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_Protocol_Driver_Function(ndis)

另请参阅

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisCloseCall

NdisCmModifyCallQoSComplete

NdisCoCreateVc

ProtocolClModifyCallQoSComplete

ProtocolCmModifyCallQoS