структура NDIS_HD_SPLIT_CURRENT_CONFIG (ntddndis.h)

Статья
02/07/2025

Структура 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_OBJECT_HEADER для структуры NDIS_HD_SPLIT_CURRENT_CONFIG. Драйвер задает элемент типа структуры, заголовка указывает NDIS_OBJECT_TYPE_DEFAULT, элемент редакции NDIS_HD_SPLIT_CURRENT_CONFIG_REVISION_1 и элемент size NDIS_SIZEOF_HD_SPLIT_CURRENT_CONFIG_REVISION_1.

HardwareCapabilities

Возможности оборудования разделения данных заголовков, поддерживаемые адаптером минипорта. Эти возможности должны включать возможности, которые в настоящее время отключены параметрами INF-файла или на странице свойств advanced . Значение HardwareCapabilities является побитовой или из следующих флагов:

NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT

Минипорт-адаптер может разделить заголовок и данные на отдельные списки дескрипторов памяти (MDLs), которые соответствуют требованиям для поддержки разделения данных заголовков.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV4_OPTIONS

Мини-адаптер может разделить кадры Ethernet IPv4, включающие параметры IPv4. Минипорт-адаптер может поддерживать разделение некоторых параметров IPv4, не разделяя другие.

Примечание сетевой адаптер не должен разделять кадры IPv4, содержащие неподдерживаемые параметры IPv4. Если кадр IPv4 разделен, часть заголовка разделенного кадра должна содержать весь заголовок IPv4 и все параметры IPv4, которые присутствуют.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV6_EXTENSION_HEADERS

Минипорт-адаптер может разделить кадры Ethernet IPv6, включающие заголовки расширения IPv6. Минипорт-адаптер может поддерживать некоторые заголовки расширений IPv6, не поддерживая другие.

примечание сетевой адаптер не должен разделять кадры IPv6, содержащие неподдерживаемые заголовки расширений IPv6. Если кадр IPv6 разделен, часть заголовка разделенного кадра должна содержать весь заголовок IPv6 и все заголовки расширения IPv6, которые присутствуют.

NDIS_HD_SPLIT_CAPS_SUPPORTS_TCP_OPTIONS

Минипорт-адаптер может разделить кадры TCP с другими параметрами TCP в дополнение к параметру метки времени. Минипорт-адаптер может поддерживать некоторые параметры TCP и не поддерживать другие.

Примечание Если единственным параметром TCP в кадре является параметр метки времени, поставщик разделения данных должен иметь возможность разделить кадр.

Примечание Если заголовок TCP содержит неподдерживаемый параметр TCP, сетевой адаптер должен разделить кадр в начале заголовка TCP или не должен разделять кадр.

CurrentCapabilities

Текущие возможности разделения данных заголовков, поддерживаемые адаптером минипорта. Минипорт-драйвер использует те же флаги, которые определены для элемента HardwareCapabilities. В этом случае флаги задаются для указания текущих возможностей, зависящих от текущих параметров конфигурации.

HDSplitFlags

Набор флагов, сообщающих о состоянии разделения данных заголовка для мини-адаптера. NDIS задает этот элемент битовой или из следующих флагов:

NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT

Минипорт-драйвер включил разделение данных заголовков в оборудовании. В противном случае разделение данных заголовков отключено.

HDSplitCombineFlags

Набор флагов, указывающих текущие параметры разделения данных заголовков мини-порта. Значение HDSplitCombineFlags может быть битовой или из следующих флагов:

NDIS_HD_SPLIT_COMBINE_ALL_HEADERS

Минипорт-адаптер объединяет разделенные кадры. Если разделение данных заголовков включено в оборудовании, минипорт-драйвер должен объединить заголовок и данные перед указанием кадра в NDIS.

BackfillSize

Размер резервной заполнения в байтах, который используется мини-драйвером для части данных разделенного кадра.

MaxHeaderSize

Максимальный размер в байтах, который драйвер минипорта используется для части заголовка разделенного кадра.

Примечание Если длина заголовка превышает MaxHeaderSize из-за наличия параметров IPv4, заголовков IPsec или заголовков расширений IPv6 кадр не должен быть разделен. Если заголовок, содержащий заголовок TCP или UDP, превышает MaxHeaderSize из-за наличия заголовка TCP, параметров TCP или заголовка UDP сетевой адаптер должен разделить кадр в начале заголовка протокола верхнего слоя или не должен разделять кадр.

Замечания

Структура NDIS_HD_SPLIT_CURRENT_CONFIG используется в OID_GEN_HD_SPLIT_CURRENT_CONFIG запрос OID, чтобы получить текущую конфигурацию разделения данных заголовков мини-адаптера.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.1 и более поздних версиях.
заголовка	ntddndis.h (include Ndis.h)

См. также

NDIS_OBJECT_HEADER

NdisMSetMiniportAttributes

OID_GEN_HD_SPLIT_CURRENT_CONFIG

Поделиться через