NDIS_QOS_PARAMETERS結構（ntddndis.h）

發行項
02/07/2025

NDIS_QOS_PARAMETERS 結構會指定支援 IEEE 802.1 資料中心橋接（DCB）介面之網路適配器上啟用的 NDIS 服務品質（QoS）參數。

語法

typedef struct _NDIS_QOS_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              NumTrafficClasses;
  UCHAR              PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES];
  UCHAR              TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  UCHAR              TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              PfcEnable;
  ULONG              NumClassificationElements;
  ULONG              ClassificationElementSize;
  ULONG              FirstClassificationElementOffset;
} NDIS_QOS_PARAMETERS, *PNDIS_QOS_PARAMETERS;

成員

Header

NDIS_QOS_PARAMETERS 結構的型別、修訂和大小。此成員的格式為 NDIS_OBJECT_HEADER 結構。

迷你埠驅動程序必須將標頭的 Type 成員設定為 NDIS_OBJECT_TYPE_QOS_PARAMETERS。若要指定 NDIS_QOS_PARAMETERS 結構的版本，驅動程式必須將 HeaderRevision 成員設定為下列值：

NDIS_QOS_PARAMETERS_REVISION_1

NDIS 6.30 和更新版本的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_QOS_PARAMETERS_REVISION_1。

Flags

ULONG 值，其中包含指定網路適配器 NDIS QoS 參數狀態之旗標的位 OR。如需此成員的詳細資訊，請參閱旗標成員概觀。

NumTrafficClasses

ULONG 值，指定網路適配器上啟用的 NDIS QoS 流量類別數目。每個流量類別都會透過範圍從零到的標識符來參考（NumTrafficClasses–1）。

NoteNumTrafficClasses 成員的值必須小於或等於 min（NDIS_QOS_MAXIMUM_TRAFFIC_CLASSESMaxNumTrafficClasses），其中 MaxNumTrafficClasses 是 NDIS_QOS_CAPABILITIES 結構中指定的 MaxNumTrafficClasses 成員的值。

PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES]

UCHAR 元素的陣列，其中每個元素都代表與 IEEE 802.1p 優先順序層級相關聯的流量類別。 PriorityAssignmentTable 陣列是由 802.1p 優先順序層級（0–7）編製索引。

每個元素都包含流量類別識別碼。此標識碼是分類數位流量類別 NDIS_QOS_CLASSIFICATION_ELEMENT 結構的索引。

Note PriorityAssignmentTable 陣列中的每個元素都必須指派有效的流量類別標識符。流量類別標識碼可以指派給 PriorityAssignmentTable 陣列中的多個元素。

TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

UCHAR 的陣列 元素，指定指派給每個流量類別的頻寬配置百分比。 TcBandwidthAssignmentTable 數位元組是由流量類別標識碼編製索引。

TcBandwidthAssignmentTable 陣列的每個元素都會指定流量類別的頻寬配置。 TcBandwidthAssignmentTable 陣列中所有頻寬配置指派的總值必須等於 100。

注意頻寬配置僅支持增強傳輸選擇（ETS） TSA。如果 TsaAssignmentTable 陣列中的流量類別元素未設定為 NDIS_QOS_TSA_ETS，則 tcBandwidthAssignmentTable 陣列中流量類別的專案必須設定為零。

TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

UCHAR 的陣列 元素，指定指派給每個流量類別的 TSA。 TsaAssignmentTable 陣列是由流量類別標識碼編製索引。

TsaAssignmentTable 陣列的每個元素都包含下列其中一個值：

NDIS_QOS_TSA_STRICT

嚴格優先順序演演算法必須當做流量類別的 TSA 使用。如需此 TSA 的詳細資訊，請參閱 Strict Priority Algorithm。

NDIS_QOS_TSA_CBS

IEEE 802.1Qav 信用型形狀器（CBS）演演算法必須作為流量類別的 TSA 使用。

注意從 Windows Server 2012 開始，DCB 元件（Msdcb.sys）不支援 CBS TSA，而且不會透過 OID_QOS_PARAMETERS的對象識別碼（OID）方法要求來啟用此參數。如需 DCB 元件的詳細資訊，請參閱資料中心橋接的 NDIS QoS 架構。

NDIS_QOS_TSA_ETS

IEEE 802.1Qaz Enhanced Transmission Selection （ETS）演演算法必須作為流量類別的 TSA 使用。如需此 TSA 的詳細資訊，請參閱增強傳輸選擇（ETS）演演算法。

PfcEnable

32 位的點陣圖。最重要的24位會保留供日後使用。最小有效 8 位可用來指定是否在 IEEE 802.1p 優先順序層級上啟用 PFC。如果位設定為一個，則會針對優先順序層級啟用 PFC。

位範圍	意義
31:24	保留供日後使用。
7	如果設定為 1，PFC 會在 802.1p 優先順序層級 7 上啟用（網路控制）。
6	如果設定為 1，PFC 會在 802.1p 優先順序層級 6 上啟用（因特網控制）。
5	如果設定為 1，PFC 會在 802.1p 優先順序層級 5 上啟用（語音）。
4	如果設定為 1，PFC 會在 802.1p 優先順序層級 4 上啟用（視訊）。
3	如果設定為一個，PFC 會在 802.1p 優先順序層級 3 上啟用（關鍵應用程式）。
2	如果設定為 1，PFC 會在 802.1p 優先順序層級 2 上啟用（出色的努力）。
1	如果設定為 1，PFC 會在 802.1p 優先順序層級 1 上啟用（背景）。
0	如果設定為 1，PFC 會在 802.1p 優先順序層級 0 上啟用（盡最大努力）。

附注已啟用 PFC 的 802.1p 優先順序層級總數必須小於或等於 NDIS_QOS_CAPABILITIES 結構中 MaxNumPfcEnabledTrafficClasses 成員的值。

如需優先順序層級的詳細資訊，請參閱 IEEE 802.1p 優先順序層級。

NumClassificationElements

ULONG 值，指定流量分類陣列中的元素數目。此陣列中第一個專案的位移是由 FirstClassificationElementOffset 成員所指定。

Note 陣列中的每個元素都會格式化為 NDIS_QOS_CLASSIFICATION_ELEMENT 結構。

ClassificationElementSize

ULONG 值，指定流量分類陣列中每個元素的大小，以位元組為單位。

附注從 NDIS 6.30 開始，這個成員必須設定為 sizeof(NDIS_QOS_CLASSIFICATION_ELEMENT]。

FirstClassificationElementOffset

ULONG 值，指定流量分類元素陣列中依循此結構之第一個專案的位移，以位元組為單位。位移是從 NDIS_QOS_PARAMETERS 結構的開頭測量到第一個專案的開頭。陣列中的每個元素都是 NDIS_QOS_CLASSIFICATION_ELEMENT 結構。

注意如果 NumClassificationElements 設為零，則會忽略此成員。

言論

NDIS_QOS_PARAMETERS 結構會指定定義網路適配器如何優先傳輸或輸出、封包的參數。此結構用於下列 OID 要求：

OID_QOS_OPERATIONAL_PARAMETERS的 OID 查詢要求。此 OID 要求會傳回目前在網路適配器上布建的作業 QoS 參數。
OID_QOS_REMOTE_PARAMETERS的 OID 查詢要求。此 OID 要求會傳回目前在網路適配器上布建的遠端 QoS 參數。
OID_QOS_PARAMETERS的 OID 方法要求。此 OID 要求會使用本機 QoS 參數布建網路適配器。

迷你埠驅動程式也會傳回下列 NDIS 狀態指示中的 NDIS_QOS_PARAMETERS 結構：

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE。此迷你埠驅動程式會在作 QoS 參數變更時發出此狀態指示。
NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE。此迷你埠驅動程式會在遠端 QoS 參數變更時發出此狀態指示。

如需 NDIS QoS 參數類型的詳細資訊，請參閱 NDIS QoS 參數概觀。

旗標成員概觀

Flags 成員包含指定網路適配器 NDIS QoS 參數狀態之旗標的位 OR。

迷你埠驅動程式會在發出下列 NDIS 狀態指示時，設定旗標成員：

DCB 元件會在發出 OID_QOS_PARAMETERS的 OID 方法要求時，設定旗標成員。

注意只有DCB元件可以發出OID要求。過度配置通訊協定或篩選驅動程式不得發出此 OID。如需 DCB 元件的詳細資訊，請參閱資料中心橋接的 NDIS QoS 架構。

下列旗標是針對 Flags 成員所定義。

注意 NDIS 保證同時設定或清除 NDIS_QOS_PARAMETERS_ETS_CONFIGURED 和 NDIS_QOS_PARAMETERS_PFC_CONFIGURED 旗標。

NDIS_QOS_PARAMETERS_Xxx_CHANGED 旗標會提供提示，指出對應的參數群組是否已從先前 OID_QOS_PARAMETERS 方法要求變更，或 NDIS_QOS_PARAMETERS_Xxx_CHANGED 狀態通知。當迷你埠驅動程序發出 NDIS_QOS_PARAMETERS_Xxx_CHANGED 狀態通知時，可以選擇性地設定這些旗標。

注意如果未設定 NDIS_QOS_PARAMETERS_Xxx_CHANGED 旗標，則過度驅動程式不得假設基礎網路適配器上支援或啟用對應的參數群組。