NDIS_QOS_CAPABILITIES结构（ntddndis.h）

项目
02/07/2025

NDIS_QOS_CAPABILITIES 结构指定支持 IEEE 802.1 数据中心桥接（DCB）接口的网络适配器的 NDIS 服务质量（QoS）功能。

语法

typedef struct _NDIS_QOS_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              MaxNumTrafficClasses;
  ULONG              MaxNumEtsCapableTrafficClasses;
  ULONG              MaxNumPfcEnabledTrafficClasses;
} NDIS_QOS_CAPABILITIES, *PNDIS_QOS_CAPABILITIES;

成员

Header

NDIS_QOS_CAPABILITIES 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将标头的类型成员设置为NDIS_OBJECT_TYPE_QOS_CAPABILITIES。若要指定 NDIS_QOS_CAPABILITIES 结构的版本，驱动程序必须将 Revision 成员标头设置为以下值：

NDIS_QOS_CAPABILITIES_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将大小成员设置为NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1。

Flags

ULONG 值，该值包含指定网络适配器支持的 NDIS QoS 功能的标志的按位 OR。定义了以下标志：

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

如果设置了此标志，则网络适配器支持严格的优先级传输选择算法（TSA）。有关此算法的详细信息，请参阅严格优先级算法。

注意为了符合 DCB，网络适配器必须支持严格的优先级 TSA。

NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED

如果设置了此标志，则网络适配器支持绕过媒体访问控制安全性（MACsec）处理的功能。有关 MACsec 的详细信息，请参阅 802.1AE-2006 标准。

NDIS_QOS_CAPABILITIES_CEE_DCBX_SUPPORTED

如果设置了此标志，网络适配器和微型端口驱动程序支持早于 IEEE 802.1Qaz 数据中心桥接 Exchange （DCBX）协议的协议。这些协议包括聚合增强型以太网（CEE）协议套件。

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

如果设置了此标志，网络适配器和微型端口驱动程序支持 IEEE 802.1Qaz DCBX 协议。 DCBX 协议允许在两个直接连接的对等方之间交换 DCB 参数。这样，这些对等方就可以调整和优化这些参数，以便优化通过连接传输的数据传输。有关此协议的详细信息，请参阅数据中心桥接概述。

注意如果设置了此标志，微型端口驱动程序必须拒绝 DCBX 数据包的任何发送请求。

MaxNumTrafficClasses

ULONG 值，该值指定网络适配器支持的最大 NDIS QoS 流量类数。有关详细信息，请参阅 NDIS QoS 流量类。

注意为了使网络适配器支持 DCB 的 NDIS QoS，它必须至少支持三个流量类。

MaxNumEtsCapableTrafficClasses

ULONG 值，该值指定网络适配器可与增强传输选择（ETS）算法一起使用的最大 QoS 流量类数。此值必须小于或等于 MaxNumTrafficClasses 成员的值。

有关 ETS 的详细信息，请参阅增强传输选择（ETS）算法。

注意为了使网络适配器支持 DCB 的 NDIS QoS，它必须至少支持两个支持 ETS 的流量类。

MaxNumPfcEnabledTrafficClasses

ULONG 值，该值指定网络适配器可与基于优先级的流控制（PFC）算法一起使用的最大 QoS 流量类数。此值必须小于或等于 MaxNumTrafficClasses 成员的值。

有关 PFC 的详细信息，请参阅基于优先级的流控制（PFC）。

注意为了使网络适配器支持 DCB 的 NDIS QoS，它必须支持至少一个支持 PFC 的流量类。

言论

微型端口驱动程序通过以下步骤从驱动程序的 MiniportInitializeEx 函数注册基础网络适配器的 NDIS QoS 功能：

微型端口驱动程序使用网络适配器的 NDIS QoS 功能初始化 NDIS_QOS_CAPABILITIES 结构。
微型端口驱动程序使用网络适配器的其他硬件辅助功能初始化 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构。驱动程序将 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的 HardwareQosCapabilities 成员设置为指向 NDIS_QOS_CAPABILITIES 结构的指针。
微型端口驱动程序调用 NdisMSetMiniportAttributes，并将 MiniportAttributes 参数设置为指向 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的指针。