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

Статья
02/07/2025

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

Синтаксис

SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;

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

Параметры

[in, out] Context

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

[in] VirtualFunction

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

[in] Buffer

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

[in] Offset

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

[in] Length

Длина( в байтах) записываемых данных.

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

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

Замечания

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

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

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

Требования

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

См. также

SetBusData

PCI_VIRTUALIZATION_INTERFACE

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