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

Статья
08/07/2023

Структура 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. Драйвер задает элемент 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 является побитовой ИЛИ следующих флагов:

NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT

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

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV4_OPTIONS

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

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

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV6_EXTENSION_HEADERS

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

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

NDIS_HD_SPLIT_CAPS_SUPPORTS_TCP_OPTIONS

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

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

Примечание Если заголовок 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 6.1 и более поздних версиях.
Верхняя часть	ntddndis.h (включая Ndis.h)

См. также раздел

NDIS_OBJECT_HEADER

NdisMSetMiniportAttributes

OID_GEN_HD_SPLIT_CURRENT_CONFIG

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