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

Статья
02/26/2024

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

Синтаксис

typedef struct _NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS;

Члены

Header

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

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

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

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

Задайте для элемента Размер значение NDIS_SIZEOF_SRIOV_READ_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) и используется только драйверами miniport для PF и VF на сетевом адаптере.

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

Length

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

BufferOffset

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

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

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

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

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

Требования

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

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

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK

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