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

Статья
02/07/2025

Структура NDIS_SWITCH_PORT_ARRAY задает массив параметров конфигурации порта. Каждый элемент в массиве задает параметры для порта расширяемого коммутатора Hyper-V. Каждый элемент отформатирован как структура NDIS_SWITCH_PORT_PARAMETERS.

Синтаксис

typedef struct _NDIS_SWITCH_PORT_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_PORT_ARRAY, *PNDIS_SWITCH_PORT_ARRAY;

Члены

Header

Тип, редакция и размер структуры NDIS_SWITCH_PORT_ARRAY. Этот элемент отформатирован как структура NDIS_OBJECT_HEADER.

Элемент типазаголовка должен иметь значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_SWITCH_PORT_ARRAY, редакции члена заголовка необходимо задать следующее значение:

NDIS_SWITCH_PORT_ARRAY_REVISION_1

Исходная версия для NDIS 6.30 и более поздних версий.

Задайте для элемента размер значение NDIS_SIZEOF_NDIS_SWITCH_PORT_ARRAY_REVISION_1.

Flags

Значение ULONG, содержащее побитовое OR флагов. Этот элемент зарезервирован для NDIS.

FirstElementOffset

Значение USHORT, указывающее смещение (в байтах) к первому элементу в массиве элементов, следовать этой структуре. Смещение измеряется с начала NDIS_SWITCH_PORT_ARRAY структуры до начала первого элемента. Каждый элемент в массиве является NDIS_SWITCH_PORT_PARAMETERS структурой.

Примечание Если numElements имеет значение нулю, этот элемент игнорируется.

NumElements

Значение ULONG, указывающее количество элементов NDIS_SWITCH_PORT_PARAMETERS, следуйте NDIS_SWITCH_PORT_ARRAY структуре.

ElementSize

Значение ULONG, указывающее размер в байтах элементов NDIS_SWITCH_PORT_PARAMETERS, которые соответствуют структуре NDIS_SWITCH_PORT_ARRAY.

Замечания

Структура NDIS_SWITCH_PORT_ARRAY возвращается в запросах OID OID_SWITCH_PORT_ARRAY. Массив структур NDIS_SWITCH_PORT_PARAMETERS следует NDIS_SWITCH_PORT_ARRAY структуре в буфере сведений, связанном с этими запросами OID. Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на этот буфер информации.

Расширения расширяемого коммутатора могут обращаться к отдельным элементам NDIS_SWITCH_PORT_PARAMETERS внутри структуры NDIS_SWITCH_PORT_ARRAY с помощью макроса NDIS_SWITCH_PORT_AT_ARRAY_INDEX.

Требования

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

См. также

NDIS_OBJECT_HEADER

NDIS_SWITCH_PORT_AT_ARRAY_INDEX

NDIS_SWITCH_PORT_PARAMETERS

OID_SWITCH_PORT_ARRAY

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