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

Статья
08/07/2023

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

Синтаксис

typedef struct _NDIS_NIC_SWITCH_VF_PARAMETERS {
  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_PARAMETERS, *PNDIS_NIC_SWITCH_VF_PARAMETERS;

Члены

Header

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

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

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

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

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

Flags

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

SwitchId

Значение NDIS_NIC_SWITCH_ID, указывающее идентификатор коммутатора. Это значение идентифицирует коммутатор сетевого адаптера, на котором выделяется виртуальныйF.

Идентификатор коммутатора — это целое число от нуля до числа коммутаторов, поддерживаемых сетевым адаптером. Значение 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 6.30 и более поздних версиях.
Верхняя часть	ntddndis.h (включая Ndis.h)

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

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_VF_PARAMETERS