функция обратного вызова GET_VIRTUAL_DEVICE_DATA (wdm.h)

Статья
02/29/2024

Подпрограмма GetVirtualFunctionData считывает данные из пространства конфигурации PCI Express (PCIe) виртуальной функции (VF) на устройстве, поддерживающем интерфейс SR-IOV.

Синтаксис

GET_VIRTUAL_DEVICE_DATA GetVirtualDeviceData;

ULONG GetVirtualDeviceData(
  [in, out] PVOID Context,
  [in]      USHORT VirtualFunction,
  [out]     PVOID Buffer,
  [in]      ULONG Offset,
  [in]      ULONG Length
)
{...}

Параметры

[in, out] Context

Указатель на сведения о контексте для конкретного интерфейса. Вызывающий объект передает значение, передаваемое в качестве элемента Contextструктуры PCI_VIRTUALIZATION_INTERFACE для интерфейса.

[in] VirtualFunction

Отсчитываемое от нуля значение, указывающее VF на устройстве, с которого считываются данные.

[out] Buffer

Указатель на буфер, содержащий сведения о конфигурации, считываемые из пространства конфигурации PCIe виртуальной машины.

[in] Offset

Смещение в пространстве конфигурации PCIe виртуальной машины. Этот элемент указывает, с чего начинается операция чтения.

[in] Length

Длина считываемых данных в байтах.

Возвращаемое значение

Подпрограмма GetVirtualFunctionData возвращает длину в байтах данных конфигурации PCIe, которые были считаны после успешной операции чтения. Если операция чтения завершается неудачно, подпрограмма возвращает ноль.

Подпрограмма GetVirtualFunctionData похожа на подпрограмму GetBusData , за исключением того, что она считывает данные конфигурации PCIe из VF, а не из физической функции устройства (PF).

Подпрограмма GetVirtualFunctionData предоставляется интерфейсом GUID_PCI_VIRTUALIZATION_INTERFACE . Подпрограмма GetBusData предоставляется интерфейсом GUID_BUS_INTERFACE_STANDARD .

Стек виртуализации вызывает GetVirtualFunctionData , когда драйвер, работающий в гостевой операционной системе, вызывает подпрограмму GetBusData .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в Windows Server 2012 и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h)
IRQL	IRQL <= APC_LEVEL

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

PCI_VIRTUALIZATION_INTERFACE

GetBusData

Share via