通过

GET_VIRTUAL_DEVICE_DATA回调函数 （wdm.h）

  • 项目

GetVirtualFunctionData 例程从支持单个根 I/O 虚拟化（SR-IOV）接口的虚拟函数（VF）的 PCI Express（PCIe）配置空间读取数据。

语法

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

指向缓冲区的指针，其中包含从 VF 的 PCIe 配置空间读取的配置信息。

[in] Offset

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

[in] Length

要读取的数据的长度（以字节为单位）。

返回值

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

言论

GetVirtualFunctionData 例程类似于 getBusData 例程，只不过它从 VF 而不是从设备的物理功能（PF）读取 PCIe 配置数据。

GetVirtualFunctionData 例程由 GUID_PCI_VIRTUALIZATION_INTERFACE 接口提供。 GetBusData 例程由 GUID_BUS_INTERFACE_STANDARD 接口提供。

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

要求

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

另请参阅

PCI_VIRTUALIZATION_INTERFACE

GetBusData