NDIS_QOS_PARAMETERS 結構 (ntddndis.h)

發行項
02/29/2024

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 結構。

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

NDIS_QOS_PARAMETERS_REVISION_1

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

將 Size 成員設定為 NDIS_SIZEOF_QOS_PARAMETERS_REVISION_1。

Flags

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

NumTrafficClasses

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

注意NumTrafficClasses 成員的值必須小於或等於 min (NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES、MaxNumTrafficClasses) ，其中 MaxNumTrafficClasses 是 NDIS_QOS_CAPABILITIES 結構中指定的 MaxNumTrafficClasses 成員值。

PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES]

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

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

注意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 的詳細資訊，請參閱嚴格優先順序演算法。

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。如果位設定為 1，則會針對優先順序層級啟用 PFC。

位元範圍	意義
31:24	保留供未來使用。
7	如果設定為 1，PFC 會在 802.1p 優先順序層級 7 上啟用， (網路控制) 。
6	如果設定為 1，PFC 會在 802.1p 優先順序層級 6 上啟用， (因特網工作控制) 。
5	如果設定為 1，則會在 802.1p 優先順序層級 5 上啟用 PFC， (語音) 。
4	如果設定為 1，則會在 802.1p 優先順序層級 4 上啟用 PFC， (視訊) 。
3	如果設定為 1，PFC 會在 802.1p 優先順序層級 3 上啟用， (關鍵應用程式) 。
2	如果設定為 1，PFC 會在 802.1p 優先順序層級 2 上啟用， (絕佳的工作) 。
1	如果設定為 1，則會在 802.1p 優先順序層級 1 上啟用 PFC， (背景) 。
0	如果設定為 1，則會在 802.1p 優先順序層級 0 上啟用 PFC， (最佳做法) 。

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

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

NumClassificationElements

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

注意數位中的每個元素都會格式化為 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 成員概觀

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

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

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

注意只有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 旗標，則過度配置驅動程式不得假設基礎網路適配器上支援或啟用對應的參數群組。