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

Статья
02/07/2025

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

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

[in] VirtualFunction

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

[out] Buffer

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

[in] Offset

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

[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 (include Wdm.h)
IRQL	IRQL <= APC_LEVEL

См. также

PCI_VIRTUALIZATION_INTERFACE

GetBusData

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