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

另请参阅

PCI_VIRTUALIZATION_INTERFACE

GetBusData