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

  • Статья

Структура 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 .

Для элемента Typeзаголовка необходимо задать значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_SWITCH_PORT_ARRAY , для элемента Revisionзаголовка должно быть задано следующее значение:

NDIS_SWITCH_PORT_ARRAY_REVISION_1

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

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

Flags

Значение ULONG, содержащее побитовое ИЛИ флагов. Этот элемент зарезервирован для 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 (включая Ndis.h, Fwpsk.h)

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

NDIS_OBJECT_HEADER

NDIS_SWITCH_PORT_AT_ARRAY_INDEX

NDIS_SWITCH_PORT_PARAMETERS

OID_SWITCH_PORT_ARRAY