NDIS_QOS_CAPABILITIES 結構 (ntddndis.h)

發行項
02/29/2024

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 值，其中包含一個位 OR 的旗標，指定網路適配器支援的 NDIS QoS 功能。已定義下列旗標：

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

如果設定此旗標，網路適配器支援嚴格的優先順序傳輸選取演算法， (TSA) 。如需此演算法的詳細資訊，請參閱 Strict Priority Algorithm。

注意為了符合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 (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 結構的指標。