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

Статья
02/29/2024

Структура 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 задает для элемента Typeзаголовка значение 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 (включая Ndis.h)

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

NDIS_NIC_SWITCH_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VFS

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