IOCTL_VPCI_READ_BLOCK IOCTL （IOCTL_VPCI_READ_BLOCK.h）

PCI Express （PCIe）虚拟函数（VF）的驱动程序发出 IOCTL_VPCI_READ_BLOCK

为了从 VF 配置块读取数据，I/O 控制代码（IOCTL）。驱动程序将此 IOCTL 颁发给驱动程序堆栈中的下一个较低驱动程序。

注意此 IOCTL 请求是由支持单个根 I/O 虚拟化（SR-IOV）接口的设备上的 PCIe VF 驱动程序颁发的。

当驱动程序发出 IOCTL_VPCI_READ_BLOCK IOCTL 时，驱动程序必须执行以下步骤：

IOCTL 请求完成结果

有关在内核模式驱动程序之间发出 IOCTL 的详细信息，请参阅在驱动程序中创建 IOCTL 请求。

Irp->IoStatus.Status 设置为STATUS_SUCCESS（如果请求成功）。

否则，状态为相应的错误条件作为 NTSTATUS 代码。

有关详细信息，请参阅 [XREF-LINK：NTSTATUS 值]。

言论

驱动程序必须首先分配或重复使用 I/O 请求数据包（IRP）。可以使用 IoBuildDeviceIoControlRequest 函数专门分配 IOCTL IRP。还可以使用常规用途 IRP 创建和初始化函数，例如 IoAllocateIrp、IoReuseIrp或 IoInitializeIrp。有关 IRP 分配的详细信息，请参阅为 Lower-Level 驱动程序创建 IRP。

然后，驱动程序必须设置 IRP 结构的成员，如下表所述。

IRP 成员	价值
UserBuffer	将包含要读取的配置数据的调用方分配缓冲区的地址。
UserEvent	调用 KeInitializeEvent 函数时初始化的事件对象的地址。注意如果不需要异步完成 IOCTL 请求，则应将此成员设置为 NULL。有关详细信息，请参阅在驱动程序中创建 IOCTL 请求。
UserIosb	调用方分配 IO_STATUS_BLOCK 结构的地址。此结构由较低驱动程序更新，以指示 I/O 请求的最终状态。

驱动程序调用 IoGetNextIrpStackLocation 函数以访问较低驱动程序的 I/O 堆栈位置。此函数返回指向包含 I/O 堆栈位置参数的 IO_STACK_LOCATION 结构的指针。

然后，驱动程序必须在 IO_STACK_LOCATION 结构中设置成员，如下表所述。

IO_STACK_LOCATION成员	价值
MajorFunction	IRP_MJ_INTERNAL_DEVICE_CONTROL
Parameters.DeviceIoControl.IoControlCode	IOCTL_VPCI_READ_BLOCK
Parameters.DeviceIoControl.Type3InputBuffer	指向 VPCI_READ_BLOCK_INPUT 结构的指针。驱动程序使用 IOCTL_VPCI_READ_BLOCK I/O 请求的参数设置此结构的格式。
IParameters.DeviceIoControl.InputBufferLength	VPCI_READ_BLOCK_INPUT 结构的大小（以字节为单位）。
Parameters.DeviceIoControl.OutputBufferLength	调用方分配的缓冲区的大小（以字节为单位）将包含要读取的配置数据。注意此值必须与 VPCI_READ_BLOCK_INPUT 结构的 BytesRequested 成员的值相同。

若要发出此 IOCTL 请求，驱动程序调用 IoCallDriver 函数，以将请求传递到驱动程序堆栈中的下一较低驱动程序。驱动程序设置 IoCallDriver 的参数，如下表所述。

IoCallDriver 参数	价值
DeviceObject	较低驱动程序的设备对象。
Irp	以前分配和初始化的 IRP 的地址。有关详细信息，请参阅准备 I/O 请求数据包（IRP）结构。

IOCTL_VPCI_READ_BLOCK IOCTL 请求完成后，调用方分配 IO_STATUS_BLOCK 结构的状态成员设置为下表中的值之一。

状态值	描述
STATUS_SUCCESS	IOCTL 已成功完成。
STATUS_PENDING	IOCTL 尚未完成。驱动程序必须调用 KeWaitForSingleObject 函数才能将当前线程置于等待状态。驱动程序将 Object 参数设置为在调用 KeInitializeEvent 函数时初始化的事件对象的地址。当 IOCTL 请求完成时，会发出该事件信号。发出事件信号后，线程将恢复执行。
STATUS_BUFFER_TOO_SMALL	Parameters.DeviceIoControl.InputBufferLength 成员或 Parameters.DeviceIoControl.OutputBufferLength 成员设置为小于所需缓冲区大小的值。