SET_VIRTUAL_DEVICE_DATA回调函数 (wdm.h)

  • 项目

SetVirtualFunctionData 例程将数据写入 PCI Express (PCIe，) 支持单根 I/O 虚拟化 (SR-IOV) 接口的设备上的虚拟函数 (VF) 的配置空间。

语法

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结构的 Context 成员传递的值。

[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