GET_VIRTUAL_DEVICE_DATA回调函数 (wdm.h)
GetVirtualFunctionData 例程从支持单根 I/O 虚拟化 (SR-IOV) 接口的设备上的虚拟函数) 配置空间的 PCI Express (PCIe 读取数据, (VF) 。
语法
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结构的 Context 成员传递的值。
[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 |