IOCTL_VPCI_READ_BLOCK IOCTL ()

驅動程式必須先配置或重複使用 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 成員已設定為小於所需緩衝區大小的值。