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

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

  • Статья

Подпрограмма 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

Указатель на сведения о контексте для конкретного интерфейса. Вызывающий объект передает значение, передаваемое в качестве элемента 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 (включая Wdm.h)
IRQL IRQL <= APC_LEVEL

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

SetBusData

PCI_VIRTUALIZATION_INTERFACE