IOCTL_VPCI_WRITE_BLOCK IOCTL （imfi.h）

PCI Express （PCIe）虛擬函式（VF）的驅動程式會發出 IOCTL_VPCI_WRITE_BLOCK I/O 控制程式碼（IOCTL），以便將數據寫入 VF 組態區塊。驅動程式會將此 IOCTL 發行至驅動程式堆疊中的下一個較低驅動程式。

注意此 IOCTL 要求是由支援單一根 I/O 虛擬化（SR-IOV）介面之裝置上的 PCIe VF 驅動程式所發出。

當驅動程式發出 IOCTL_VPCI_WRITE_BLOCK 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	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_SUCCESS	IOCTL 已順利完成。
STATUS_PENDING	IOCTL 尚未完成。驅動程式必須呼叫 KeWaitForSingleObject 例程，才能讓目前的線程進入等候狀態。驅動程式會將 Object 參數設定為呼叫 KeInitializeEvent 例程中初始化的事件物件位址。當 IOCTL 要求完成時，事件會發出訊號。事件發出訊號后，線程就會繼續執行。
STATUS_BUFFER_TOO_SMALL	Parameters.DeviceIoControl.InputBufferLength 成員設定為小於 VPCI_WRITE_BLOCK_INPUT 結構大小的值。