通过

SET_VIRTUAL_DEVICE_DATA回调函数 （wdm.h）

  • 项目

SetVirtualFunctionData 例程将数据写入支持单个根 I/O 虚拟化（SR-IOV）接口的设备上的虚拟函数（PCIe）配置空间。

语法

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

指向缓冲区的指针，其中包含要写入 VF 的 PCIe 配置空间的配置信息。

[in] Offset

VF 的 PCIe 配置空间数据的偏移量。 此成员指定此写入作的开始位置。

[in] Length

要写入的数据的长度（以字节为单位）。

返回值

*SetVirtualFunctionData 例程返回成功写入作后写入的 PCIe 配置数据的长度（以字节为单位）。 如果写入作失败，则例程返回零。

言论

*SetVirtualFunctionData 例程类似于 SetBusData 例程，只不过它将 PCIe 配置数据写入 VF 而不是设备的物理功能（PF）。

*SetVirtualFunctionData 例程由 GUID_PCI_VIRTUALIZATION_INTERFACE 接口提供。 SetBusData 例程由 GUID_BUS_INTERFACE_STANDARD 接口提供。

当来宾作系统中运行的驱动程序调用 SetBusData 例程时，虚拟化堆栈调用 *SetVirtualFunctionData。

要求

要求 价值
最低支持的客户端 在 Windows Server 2012 及更高版本的 Windows 中受支持。
目标平台 桌面
标头 wdm.h （包括 Wdm.h）
IRQL IRQL <= APC_LEVEL

另请参阅

SetBusData

PCI_VIRTUALIZATION_INTERFACE