NDIS_QOS_CAPABILITIES 结构 (ntddndis.h)

项目
08/07/2023

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 结构。

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

NDIS_QOS_CAPABILITIES_REVISION_1

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

将 Size 成员设置为 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 结构的指针。