IOCTL_VPCI_READ_BLOCK IOCTL (vpci.h)

驱动程序必须首先分配或重用 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 成员将设置为下表中的值之一。

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