VPCI_READ_BLOCK回调函数 (vpci.h)

ReadVfConfigBlock 例程读取 PCI Express (PCIe) 虚拟函数 (VF) 的配置数据块。此例程由支持单根 I/O 虚拟化 (SR-IOV) 接口的设备上的 PCIe VF 驱动程序调用。

语法

VPCI_READ_BLOCK VpciReadBlock;

NTSTATUS VpciReadBlock(
  PVOID Context,
  ULONG BlockId,
  PVOID Buffer,
  ULONG Length
)
{...}

Context

[in]指向特定于接口的上下文信息的指针。调用方传递的值作为接口的VPCI_INTERFACE_STANDARD结构的 Context 成员传递。

BlockId

[in]要读取的 VF 配置块的标识符。此标识符是独立硬件供应商 (IHV) 专有的，仅由设备上 PCIe 物理功能 (PF) 和 VF 的驱动程序使用。

Buffer

[out]指向调用方分配的缓冲区的指针，该缓冲区将包含要读取的配置数据。有关详细信息，请参阅“备注”。

Length

[in]要从 VF 配置块读取的字节数。

注意

此参数的值不能超过 VPCI_MAX_READ_WRITE_BLOCK_SIZE。

如果操作成功， ReadVfConfigBlock 例程将返回 STATUS_SUCCESS 。否则，例程将返回相应的 NTSTATUS 值。

调用 ReadVfConfigBlock 例程时，将通知 PF 的驱动程序从指定的 VF 配置块返回数据。

VF 配置块用于 PF 的驱动程序与支持 SR-IOV 接口的设备上的 VF 之间的反向通道通信。 IHV 可以为设备定义一个或多个 VF 配置块。每个 VF 配置块都有 IHV 定义的格式、长度和块 ID。

VF 配置数据可以在以下驱动程序之间以受保护的方式交换：

每个 VF 配置块中的数据仅由 PF 和 VF 的驱动程序使用。

注意

IOCTL_VPCI_READ_BLOCK IOCTL 提供了 ReadVfConfigBlock 例程的异步替代方法。