OID_QOS_PARAMETERS

  • 项目

数据中心桥接 (DCB) 组件 (Msdcb.sys) 发出对象标识符 (OID) 方法请求，OID_QOS_PARAMETERS在网络适配器上配置本地 NDIS 服务质量 (QoS) 参数。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向NDIS_QOS_PARAMETERS结构的指针。

注意 对于支持 IEEE 802.1 数据中心桥接 (DCB) 接口的 NDIS QoS 的微型端口驱动程序，此 OID 方法请求是必需的。

注解

微型端口驱动程序通过 OID_QOS_PARAMETERS 的 OID 方法请求获取本地 NDIS QoS 参数。 这些参数定义网络适配器如何确定数据包的传输或 出口的优先级。 有关这些参数的详细信息，请参阅 NDIS QoS 参数概述。

注意 只有 DCB 组件可以发出OID_QOS_PARAMETERS的 OID 方法请求。 过分协议或筛选器驱动程序不得颁发此 OID。 有关 DCB 组件的详细信息，请参阅 数据中心桥接的 NDIS QoS 体系结构。

DCB 组件在以下情况下发出OID_QOS_PARAMETERS请求：

  • 系统管理员安装或卸载 Microsoft DCB 服务器功能。

    有关 DCB 服务器功能的详细信息，请参阅 系统提供的 DCB 组件。

  • 系统管理员在功能仍处于安装状态时启用或禁用 DCB 服务器功能。

  • 系统管理员更改任何 DCB 服务器功能参数。

  • 安装 DCB 服务器功能时，操作系统将启动或重启。

当微型端口驱动程序处理 OID_QOS_PARAMETERS 的 OID 方法请求时，它必须遵循以下准则：

  • 微型端口驱动程序将 NDIS_QOS_PARAMETERS 结构中的数据复制到其本地 NDIS QoS 参数的缓存中。 然后，驱动程序根据本地 NDIS QoS 参数的缓存以及从远程对等方接收的 NDIS QoS 参数缓存解析其操作 NDIS QoS 参数。

    有关微型端口驱动程序如何解析其操作参数的详细信息，请参阅 解析操作 NDIS QoS 参数。

  • 微型端口驱动程序不得修改 NDIS_QOS_PARAMETERS 结构中包含的任何数据。 驱动程序必须完成 OID 方法请求，并在 NDIS_QOS_PARAMETERS 结构中返回原始数据。

  • NDIS_QOS_PARAMETERS_WILLING标志指定微型端口驱动程序是启用或禁用本地数据中心桥接 Exchange (DCBX) 愿意状态。 驱动程序按以下方式处理此标志：

    • 如果设置了此标志，微型端口驱动程序必须启用本地 DCBX 愿意状态。 这允许使用 QoS 设置远程配置驱动程序。 在这种情况下，驱动程序会根据远程 QoS 参数解析其操作 QoS 参数。 微型端口驱动程序还可以根据独立硬件供应商 (IHV) 定义的任何专有 QoS 设置来解析其操作 QoS 参数。

    • 如果未设置此标志，微型端口驱动程序必须禁用本地 DCBX 愿意状态。 这允许驱动程序从其本地 QoS 参数而不是远程 QoS 参数解析其操作 QoS 参数。 微型端口驱动程序还必须禁用或替代未设置相关 NDIS_QOS_PARAMETERS_Xxx_CONFIGURED 标志的任何本地 QoS 参数。

      例如，微型端口驱动程序可以使用 IHV 定义的 QoS 参数的专有设置替代未配置的本地 QoS 参数。 如果没有使用 NDIS_QOS_PARAMETERS_Xxx_CONFIGURED 标志指定的本地 QoS 参数的专有设置，驱动程序必须在网络适配器上禁用这些 QoS 参数。

      注意 如果配置的本地 QoS 参数泄露了网络适配器上启用的协议或技术使用的 QoS 参数，驱动程序还可以替代这些参数。 例如，如果通过以太网上的光纤通道为网络适配器启用远程启动，驱动程序可以替代本地 QoS 参数 (FCoE) 协议。

    有关本地 DCBX 愿意状态的详细信息，请参阅 管理本地 DCBX 愿意状态。

有关微型端口驱动程序如何替代本地 QoS 参数的详细信息，请参阅 管理 NDIS QoS 参数。

注意 重写本地 QoS 参数不应导致微型端口驱动程序使OID_QOS_PARAMETERS的 OID 方法请求失败。

有关微型端口驱动程序如何管理本地 QoS 参数的详细信息，请参阅 设置本地 NDIS QoS 参数。

返回状态代码

微型端口驱动程序返回以下状态代码之一。

状态代码 说明

NDIS_STATUS_SUCCESS

OID 请求已成功完成。

NDIS_STATUS_PENDING

OID 请求正在等待完成。 当微型端口驱动程序调用 NdisMOidRequestComplete 时，NDIS 将在请求完成后将最终状态代码和结果传递给调用方 OID 请求完成处理程序。

NDIS_STATUS_NOT_SUPPORTED

微型端口驱动程序不支持 NDIS QoS 接口。

NDIS_STATUS_INVALID_PARAMETER

NDIS_QOS_PARAMETERS 结构的一个或多个成员包含不正确的值。

NDIS_STATUS_INVALID_LENGTH

信息缓冲区的 长度小于大小 (NDIS_QOS_PARAMETERS) 。 NDIS 设置数据。QUERY_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。

NDIS_STATUS_FAILURE

由于其他原因，请求失败。

要求

版本

在 NDIS 6.30 及更高版本中受支持。

标头

 Ntddndis.h (包括 Ndis.h)

另请参阅

NdisMOidRequestComplete

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE