IOCTL_VPCI_WRITE_BLOCK IOCTL (vpci.h)

PCI Express (PCIe) 虚拟函数的驱动程序 (VF) (IOCTL) 发出IOCTL_VPCI_WRITE_BLOCK I/O 控制代码，以便将数据写入 VF 配置块。驱动程序将此 IOCTL 颁发给驱动程序堆栈中下一个较低的驱动程序。

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

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

有关在内核模式驱动程序之间发出 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	NULL
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_WRITE_BLOCK
Parameters.DeviceIoControl.Type3InputBuffer	指向 VPCI_WRITE_BLOCK_INPUT 结构的指针。驱动程序使用 IOCTL_VPCI_WRITE_BLOCK I/O 请求的参数设置此结构的格式。
IParameters.DeviceIoControl.InputBufferLength	VPCI_WRITE_BLOCK_INPUT结构的大小（以字节为单位）。
Parameters.DeviceIoControl.OutputBufferLength	零个

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

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

IOCTL_VPCI_WRITE_BLOCK IOCTL 请求完成后，调用方分配IO_STATUS_BLOCK结构的 Status 成员将设置为下表中的值之一：：

状态值	说明
STATUS_SUCCESS	IOCTL 已成功完成。
STATUS_PENDING	IOCTL 尚未完成。驱动程序必须调用 KeWaitForSingleObject 例程，以便将当前线程置于等待状态。驱动程序将 Object 参数设置为在调用 KeInitializeEvent 例程时初始化的事件对象的地址。当 IOCTL 请求完成时，事件会发出信号。发出事件信号后，线程将继续执行。
STATUS_BUFFER_TOO_SMALL	Parameters.DeviceIoControl.InputBufferLength 成员设置为小于VPCI_WRITE_BLOCK_INPUT结构的大小（以字节为单位）的值。