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

Статья
02/26/2024

Структура NDIS_NIC_SWITCH_INFO_ARRAY указывает массив. Каждый элемент в массиве задает атрибуты коммутатора сетевого адаптера, созданного в сетевом адаптере.

Синтаксис

typedef struct _NDIS_NIC_SWITCH_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_INFO_ARRAY, *PNDIS_NIC_SWITCH_INFO_ARRAY;

Члены

Header

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

NDIS задает для элемента Typeзаголовка значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_NIC_SWITCH_INFO_ARRAY , NDIS присваивает члену Редакциизаголовка следующее значение:

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

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

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

FirstElementOffset

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

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

NumElements

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

ElementSize

Значение ULONG, указывающее размер (в байтах) каждого элемента, следующего за структурой NDIS_NIC_SWITCH_INFO_ARRAY .

Когда NDIS обрабатывает запрос OID OID_NIC_SWITCH_ENUM_SWITCHES, он возвращает указатель на структуру NDIS_NIC_SWITCH_INFO_ARRAY в элементе InformationBufferNDIS_OID_REQUEST.
Когда NDIS вызывает функцию ProtocolBindAdapterEx , NDIS передает указатель на структуру NDIS_BIND_PARAMETERS в параметре BindParameters . NDIS задает элемент NicSwitchArray структуры NDIS_BIND_PARAMETERS указателем на NDIS_NIC_SWITCH_INFO_ARRAY структуру.
Когда NDIS вызывает функцию FilterAttach , NDIS передает указатель на структуру NDIS_FILTER_ATTACH_PARAMETERS в параметре AttachParameters . NDIS присваивает члену NicSwitchArrayструктуры NDIS_FILTER_ATTACH_PARAMETERS указатель на NDIS_NIC_SWITCH_INFO_ARRAY структуру.

Каждый элемент массива, следующий за NDIS_NIC_SWITCH_INFO_ARRAY структурой, является NDIS_NIC_SWITCH_INFO структурой.

Примечание Начиная с NDIS 6.30, только NDIS_NIC_SWITCH_INFO , описывающий сведения о коммутаторе сетевого адаптера по умолчанию, возвращается через запрос OID OID_NIC_SWITCH_ENUM_SWITCHES.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.30 и более поздних версиях.
Верхняя часть	ntddndis.h (включая Ndis.h)