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

  • Статья

Структура 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 .

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

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 (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 см. в разделе Путь к данным VF SR-IOV.

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_ARRAY возвращается одна или несколько NDIS_NIC_SWITCH_VF_INFO структур.

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

Требования

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

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF