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

Статья
08/07/2023

Структура NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS определяет параметры операции записи в блоке конфигурации виртуальной функции (VF) PCI Express (PCIe). Эти параметры используются для обратного канала связи между VF и драйверами мини-порта PCIe Physical Function (PF).

Синтаксис

typedef struct _NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS;

Члены

Header

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

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

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

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

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

VFId

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

Примечание VF с указанным значением NDIS_SRIOV_FUNCTION_ID должны иметь ресурсы, которые ранее были выделены с помощью запроса метода OID OID_NIC_SWITCH_ALLOCATE_VF.

BlockId

Значение ULONG, указывающее идентификатор блока конфигурации VF для записи. Этот идентификатор является собственностью независимого поставщика оборудования (IHV) и используется только драйверами мини-портов для PF и VF на сетевом адаптере.

Дополнительные сведения см. в разделе «Примечания».

Length

Значение ULONG, указывающее длину операции записи (в единицах в байтах).

BufferOffset

Значение ULONG, указывающее смещение (в единицах байтов) от начала этой структуры до буфера, содержащего данные для записи в указанный блок конфигурации VF.

Блок конфигурации VF используется для обмена данными между драйверами PCIe PF и VF на устройстве, поддерживающем интерфейс SR-IOV. Данные из блока конфигурации VF можно обмениваться между следующими драйверами:

Драйвер VF miniport, который работает в гостевой операционной системе. Эта операционная система работает в дочернем разделе Hyper-V.
Драйвер мини-порта PF, который выполняется в операционной системе управления.
Эта операционная система работает в родительском разделе Hyper-V.

Примечание Использование блока конфигурации VF и формат его данных конфигурации определяются независимым поставщиком оборудования (IHV) устройства. Данные конфигурации используются только драйверами мини-портов PF и VF.

Дополнительные сведения о взаимодействии с серверным каналом в интерфейсе SR-IOV в рамках единого корневого интерфейса виртуализации ввода-вывода см. в разделе Sr-IOV PF/VF Backchannel Communication.

Требования

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

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

NDIS_OBJECT_HEADER

OID_SRIOV_WRITE_VF_CONFIG_BLOCK

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