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

Статья
02/07/2025

Структура NDIS_NIC_SWITCH_VF_INFO_ARRAY указывает массив. Каждый элемент в массиве задает атрибуты виртуальных функций PCI Express (PCIe), которые были включены и выделены на сетевом адаптере.

Синтаксис

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

Члены

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

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

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

Flags

Значение ULONG, содержащее побитовое ЗНАЧЕНИЕ ИЛИ следующих флагов:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Если этот флаг задан, минипорт-драйвер должен возвращать только массив структур NDIS_NIC_SWITCH_VF_INFO для виртуальных машин, выделенных на коммутатор сетевого адаптера, указанный элементом SwitchId. Дополнительные сведения см. в разделе "Примечания".

Если для элемента Flags задано нулевое значение, минипорт-драйвер должен вернуть массив NDIS_NIC_SWITCH_VF_INFO структур для каждого виртуальногоF, выделенного на каждом коммутаторе сетевого адаптера сетевого адаптера.

Примечание начиная с Windows Server 2012 интерфейс SR-IOV поддерживает только коммутатор сетевого адаптера по умолчанию на сетевом адаптере. Таким образом, мини-драйвер должен возвращать только массив структур NDIS_NIC_SWITCH_VF_INFO для каждого виртуальногоF, выделенного на коммутатор сетевого адаптера по умолчанию.

SwitchId

Значение NDIS_NIC_SWITCH_ID, указывающее идентификатор коммутатора. Идентификатор коммутатора представляет собой целое число между нулем и числом коммутаторов, поддерживаемых сетевым адаптером. Значение NDIS_DEFAULT_SWITCH_ID указывает коммутатор сетевого адаптера по умолчанию.

примечание начиная с Windows Server 2012 интерфейс SR-IOV поддерживает только коммутатор сетевого адаптера по умолчанию, созданный на сетевом адаптере. Поэтому этот элемент всегда должен иметь значение NDIS_DEFAULT_SWITCH_ID.

FirstElementOffset

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

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

NumElements

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

ElementSize

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

Замечания

NDIS возвращает структуру NDIS_NIC_SWITCH_VF_INFO_ARRAY при обработке запроса метода OID OID_NIC_SWITCH_ENUM_VFS. Каждый элемент в массиве, который следует NDIS_NIC_SWITCH_VF_INFO_ARRAY структуре является элементом
структура NDIS_NIC_SWITCH_VF_INFO.

Требования

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

См. также

NDIS_NIC_SWITCH_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VFS

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