IOCTL_MPIO_PASS_THROUGH_PATH IOCTL (ntddscsi.h)
此 I/O 控制程式碼可讓應用程式或核心驅動程式將 SCSI 命令傳送至指定的實際 LUN。 下列限制適用於使用此 I/O 控制項程式代碼:
- 如果虛擬 LUN 的類別驅動程式存在,應用程式必須將要求傳送至該類別驅動程式。 因此,只有當裝置沒有類別驅動程式時,應用程式才能將此要求直接傳送至 MPIO。
- 所有傳遞要求都必須是同步的。
- 應用程式不需要系統管理許可權,就能將傳遞要求傳送至裝置,但它們必須具有裝置的讀取/寫入存取權。
- 要求包含內嵌 SCSI_PASS_THROUGH 結構) 以及特定指示詞中的 SCSI 傳遞要求 (。
- SCSI 傳遞結構應符合這類需求,如 SCSI_PASS_THROUGH中所述。
- 如果要透過宣告實際 LUN 的 DSM 傳送要求,則必須指出該要求。 在這種情況下,DSM 本身必須指出相同的實際 LUN。 否則,要求將會失敗。
- 要求必須根據先前的 SCSI 位址或其 MPIO PathId 來指定虛擬 LUN 所組成的實際 LUN,但不能同時由兩者組成。
主要程序代碼
輸入緩衝區
Parameters.DeviceIoControl.InputBufferLength 指出 Irp-AssociatedIrp.SystemBuffer> 緩衝區的大小,以位元組為單位。
輸入緩衝區長度
緩衝區 的大小必須至少 為 (MPIO_PASS_THROUGH_PATH) ,或者,如果 32 位應用程式在 64 位作業系統中傳送, 則 sizeof (MPIO_PASS_THROUGH_PATH32) 。
輸出緩衝區
埠驅動程式會傳回任何要求感知數據,以及從裝置傳輸到 Irp-AssociatedIrp.SystemBuffer> 緩衝區的任何數據。
輸出緩衝區長度
內嵌SCSI_PASS_THROUGH結構中的 SenseInfoLength 和 DataTransferLength 成員會更新,以指出傳輸的數據量。
狀態區塊
[資訊] 位元位會設定為 Irp-AssociatedIrp.SystemBuffer> 輸出緩衝區中傳回的位元組數目。 [狀態] 欄位會設定為 [STATUS_SUCCESS],或者如果未正確設定內嵌SCSI_PASS_THROUGH中的輸入 Length 值,則可能會STATUS_BUFFER_TOO_SMALL或STATUS_INVALID_PARAMETER。
規格需求
需求 | 值 |
---|---|
標頭 | ntddscsi.h (包含 Ntddscsi.h) |