NDIS_HD_SPLIT_CURRENT_CONFIG 結構 (ntddndis.h)

發行項
02/29/2024

NDIS_HD_SPLIT_CURRENT_CONFIG 結構提供迷你埠配接器的目前標頭數據分割組態。

語法

typedef struct _NDIS_HD_SPLIT_CURRENT_CONFIG {
  NDIS_OBJECT_HEADER Header;
  ULONG              HardwareCapabilities;
  ULONG              CurrentCapabilities;
  ULONG              HDSplitFlags;
  ULONG              HDSplitCombineFlags;
  ULONG              BackfillSize;
  ULONG              MaxHeaderSize;
} NDIS_HD_SPLIT_CURRENT_CONFIG, *PNDIS_HD_SPLIT_CURRENT_CONFIG;

成員

Header

NDIS_HD_SPLIT_CURRENT_CONFIG 結構的NDIS_OBJECT_HEADER結構。驅動程式會將 Header 所指定結構的 Type 成員設定為NDIS_OBJECT_TYPE_DEFAULT、將 Revision 成員設定為 NDIS_HD_SPLIT_CURRENT_CONFIG_REVISION_1，並將 Size 成員設定為 NDIS_SIZEOF_HD_SPLIT_CURRENT_CONFIG_REVISION_1。

HardwareCapabilities

迷你埠配接器支援的標頭數據分割硬體功能。這些功能應該包括 INF 檔案設定目前停用的功能，或透過 [ 進階屬性] 頁面停用的功能。 HardwareCapabilities 的值是下列旗標的位 OR：

NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT

迷你埠配接器可以將標頭和數據分割成個別的記憶體描述元清單， (MDL) ，以符合標頭數據分割支援的需求。

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV4_OPTIONS

迷你埠適配卡可以分割包含 IPv4 選項的 IPv4 乙太網路框架。迷你埠適配卡可以支援分割某些 IPv4 選項，但無法分割其他選項。

注意 NIC 不得分割包含不支援 IPv4 選項的 IPv4 畫面格。如果分割 IPv4 框架，分割框架的標頭部分必須包含整個 IPv4 標頭和所有存在的 IPv4 選項。

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV6_EXTENSION_HEADERS

迷你埠配接器可以分割包含 IPv6 擴充功能標頭的 IPv6 乙太網路框架。迷你埠適配卡可以支援某些 IPv6 擴充功能標頭，但不支援其他標頭。

注意 NIC 不得分割包含不支援 IPv6 擴充功能標頭的 IPv6 畫面格。如果分割 IPv6 框架，分割框架的標頭部分必須包含整個 IPv6 標頭和所有存在的 IPv6 延伸模組標頭。

NDIS_HD_SPLIT_CAPS_SUPPORTS_TCP_OPTIONS

迷你埠配接器除了時間戳選項之外，還可以與其他 TCP 選項分割 TCP 框架。迷你埠配接器可以支援某些 TCP 選項，也不支援其他選項。

注意如果框架中唯一的 TCP 選項是時間戳選項，數據分割提供者必須能夠分割框架。

注意如果 TCP 標頭包含不支援的 TCP 選項，NIC 必須在 TCP 標頭開頭分割框架，或不得分割框架。

CurrentCapabilities

迷你埠配接器支援的目前標頭數據分割功能。迷你埠驅動程式會使用針對 HardwareCapabilities 成員定義的相同旗標。在此情況下，旗標會設定為指出相依於目前組態設定的目前功能。

HDSplitFlags

一組旗標，報告迷你埠配接器標頭數據分割的狀態。 NDIS 會以下列旗標的位 OR 來設定此成員：

NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT

迷你埠驅動程式已在硬體中啟用標頭數據分割。否則，會停用標頭數據分割。

HDSplitCombineFlags

一組旗標，指定迷你埠配接器的目前標頭數據分割設定。 HDSplitCombineFlags 的值可以是下列旗標的位 OR：

NDIS_HD_SPLIT_COMBINE_ALL_HEADERS

迷你埠配接器正在合併分割框架。如果硬體中已啟用標頭數據分割，迷你埠驅動程序應該先結合標頭和數據，再將框架指示為NDIS。

BackfillSize

迷你埠驅動程式用於分割框架之數據部分的回填大小，以位元組為單位。

MaxHeaderSize

迷你埠驅動程式用於分割框架標頭部分的大小上限，以位元組為單位。

注意如果標頭的長度超過 MaxHeaderSize ，因為 IPv4 選項、IPsec 標頭或 IPv6 延伸模組標頭存在，則框架不得分割。如果包含 TCP 或 UDP 標頭的標頭因為 TCP 標頭、TCP 選項或 UDP 標頭的存在而超過 MaxHeaderSize，NIC 必須在上層通訊協定標頭的開頭分割框架，或不得分割框架。

備註

NDIS_HD_SPLIT_CURRENT_CONFIG 結構用於 OID_GEN_HD_SPLIT_CURRENT_CONFIG OID 查詢要求，以取得迷你埠配接器的目前標頭數據分割組態。

規格需求

需求	值
最低支援的用戶端	NDIS 6.1 和更新版本支援。
標頭	ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_OBJECT_HEADER

NdisMSetMiniportAttributes

OID_GEN_HD_SPLIT_CURRENT_CONFIG

共用方式為