структура NDIS_NIC_SWITCH_VF_PARAMETERS (ntddndis.h)
В 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 указывает на коммутатор сетевого адаптера по умолчанию.
VMName
Значение NDIS_VM_NAME, указывающее внутреннее имя дочерней секции Hyper-V, присоединенной к VF.
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_PARAMETERS используется в запросах метода OID OID_NIC_SWITCH_ALLOCATE_VF и OID_NIC_SWITCH_VF_PARAMETERS.
Дополнительные сведения об интерфейсе SR-IOV см. в статье Обзор виртуализации однокорневого ввода-вывода (SR-IOV).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается в NDIS 6.30 и более поздних версиях. |
| Верхняя часть | ntddndis.h (включая Ndis.h) |
См. также раздел