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

Статья
02/07/2025

Структура 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 задает элемент типазаголовка 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 возвращает структуру NDIS_NIC_SWITCH_INFO_ARRAY следующим образом:

При обработке запроса OID OID_NIC_SWITCH_ENUM_SWITCHESNDIS возвращает указатель на структуру NDIS_NIC_SWITCH_INFO_ARRAY в элементе NDIS_OID_REQUESTInformationBuff er.
Когда NDIS вызывает функцию ProtocolBindAdapterEx, NDIS передает указатель на структуру NDIS_BIND_PARAMETERS в параметре BindParameters. NDIS задает элемент NicSwitchArray структуры NDIS_BIND_PARAMETERS указателем на структуру NDIS_NIC_SWITCH_INFO_ARRAY.
При вызове функции 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 (include Ndis.h)