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

Статья
02/07/2025

Структура NDIS_NIC_SWITCH_VF_INFO указывает сведения о виртуальной функции PCI Express (PCIe), выделенной на сетевом адаптере.

Синтаксис

typedef struct _NDIS_NIC_SWITCH_VF_INFO {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_INFO, *PNDIS_NIC_SWITCH_VF_INFO;

Члены

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

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

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

Flags

Значение ULONG, содержащее побитовое ЗНАЧЕНИЕ ИЛИ флагов. Этот элемент зарезервирован для NDIS.

SwitchId

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

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

VMName

Значение NDIS_VM_NAME, указывающее имя дочерней секции Hyper-V, присоединенной к VF. Этот элемент содержит понятное описание раздела.

Примечание дочерний раздел Hyper-V также называется виртуальной машиной.

VMFriendlyName

Значение NDIS_VM_FRIENDLYNAME, указывающее внешнее имя дочерней секции Hyper-V, присоединенной к VF. Этот элемент содержит понятное описание раздела.

NicName

Значение NDIS_SWITCH_NIC_NAME, указывающее имя сетевого адаптера виртуальной машины. Этот элемент содержит понятное описание сетевого адаптера.

Сетевой адаптер виртуальной машины — это виртуальное устройство, которое предоставляется в гостевой операционной системе, которая выполняется в дочерней секции Hyper-V. Группа сетевых адаптеров виртуальной машины с сетевым адаптером VF предоставляет аппаратный путь к данным VF через интерфейс SR-IOV.

Дополнительные сведения о пути к данным VF см. в SR-IOVпути данных VF.

MacAddressLength

Значение USHORT, указывающее длину permanentMacAddress и элементов CurrentMacAddress.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Постоянный MAC-адрес VF. Это постоянный MAC-адрес сетевого адаптера VF, который предоставляется в гостевой операционной системе.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Текущий MAC-адрес VF. Это текущий MAC-адрес сетевого адаптера VF, который предоставляется в гостевой операционной системе.

VFId

Значение NDIS_SRIOV_FUNCTION_ID, указывающее уникальный идентификатор VF в сетевом адаптере.

RequestorId

NDIS_VF_RID, указывающий идентификатор запрашивателя PCI Express (PCIe) (RID) VF.

Замечания

Структура NDIS_NIC_SWITCH_VF_INFO содержит сведения о VF, созданном ранее с помощью запроса метода OID OID_NIC_SWITCH_ALLOCATE_VF. При выдаче этого запроса OID одна или несколько NDIS_NIC_SWITCH_VF_INFO структур возвращаются в NDIS_NIC_SWITCH_VF_INFO_ARRAY структуре.

Дополнительные сведения об интерфейсе SR-IOV см. в обзоре виртуализации одно корневых операций ввода-вывода (SR-IOV).

Требования

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

См. также

NDIS_NIC_SWITCH_VF_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

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