共用方式為


IOCTL_SCSI_PASS_THROUGH IOCTL (ntddscsi.h)

允許應用程式將幾乎任何 SCSI 命令傳送至目標裝置,但有下列限制:

  • 不允許多目標命令,例如 COPY。
  • 不支援雙向數據傳輸作業。
  • 如果裝置目標類型的類別驅動程式存在,則必須將要求傳送至該類別驅動程式。 因此,只有在連線到該 LU 的裝置類型沒有類別驅動程式時,應用程式才能將此要求直接傳送至目標邏輯單元 (LU) 。 在處理傳遞要求之前,系統埠驅動程式不會檢查裝置是否已由類別驅動程式宣告。 因此,如果應用程式略過已宣告裝置的類別驅動程式,並將該裝置的傳遞要求直接傳送至埠驅動程式,則類別驅動程式與應用程式之間可能會發生裝置控制衝突。 如果傳遞要求傳送至配接器裝置物件,而且其源自使用者模式,並且以類別驅動程式所宣告的 LU 為目標,Storport 會失敗要求並STATUS_INVALID_DEVICE_REQUEST。 如果要求傳送至 LU 裝置物件、源自核心模式,或以未宣告的 LU 為目標,則會傳遞至迷你埠驅動程式。
  • 如果 CDB 可能需要基礎迷你埠驅動程式直接存取記憶體,則無法使用此要求。 如果呼叫端的CDB可能需要直接存取記憶體,請改用 IOCTL_SCSI_PASS_THROUGH_DIRECT
  • 應用程式不得嘗試以異步方式傳送傳遞要求。 所有傳遞要求都必須是同步的。
  • 應用程式不需要系統管理許可權,即可將傳遞要求傳送至裝置,但必須具有裝置的讀取/寫入許可權。
呼叫的應用程式會建立 SCSI 命令描述元區塊,當 CHECK CONDITION 發生時,可以包含要求感知數據的要求。

IOCTL_SCSI_PASS_THROUGH 是緩衝的裝置控制要求。 若要略過系統記憶體中的緩衝處理,呼叫端應該使用 IOCTL_SCSI_PASS_THROUGH_DIRECT。 處理 IOCTL_SCSI_PASS_THROUGH_DIRECT 要求時,系統會鎖定用戶記憶體中的緩衝區,而裝置會直接存取此記憶體。

此要求通常用於傳輸少量數據, (<16K) 。

應用程式可以透過 IRP_MJ_DEVICE_CONTROL 要求傳送此要求。

記憶體類別驅動程式會將次要 IRP 號碼設定為 IRP_MN_SCSI_CLASS,以指出已由記憶體類別驅動程式處理要求。

注意 未來可能會變更或無法使用 SCSI 埠驅動程式和 SCSI 迷你埠驅動程式模型。 相反地,我們建議使用 Storport 驅動程式Storport 迷你埠 驅動程式模型。
 

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

此結構包含 SCSI CDB,呼叫端必須初始化,但路徑、目標標識碼和邏輯單元號碼除外, (LUN) 填入埠驅動程式。 針對數據輸出命令,要傳輸的數據會包含在 SCSI_PASS_THROUGH 結構的 Irp-AssociatedIrp.SystemBuffer> 緩衝區中。 不過,如果呼叫端要求要求要求感知數據,則呼叫端必須緊接在 SCSI_PASS_THROUGH之後配置額外的記憶體。

輸入緩衝區長度

Parameters.DeviceIoControl.InputBufferLength 會指出 Irp->AssociatedIrp.SystemBuffer 緩衝區的大小,這至少必須是 (感知數據大小 + 大小of (SCSI_PASS_THROUGH) ) 。 SCSI_PASS_THROUGH結構的大小會根據其 DataTransferLength 規格而有所不同。

輸出緩衝區

埠驅動程式會傳回任何要求感知數據,以及從裝置傳輸到 Irp-AssociatedIrp.SystemBuffer> 緩衝區的任何數據。

輸出緩衝區長度

SCSI_PASS_THROUGH 結構中的 SenseInfoLengthDataTransferLength 會更新,以指出傳輸的數據量。

狀態區塊

[資訊] 位元位會設定為 Irp-AssociatedIrp.SystemBuffer> 輸出緩衝區中傳回的位元組數目。 [狀態] 欄位會設定為 [STATUS_SUCCESS],或者如果SCSI_PASS_THROUGH中的輸入Length 值未正確設定,則可能會STATUS_BUFFER_TOO_SMALL或STATUS_INVALID_PARAMETER。

規格需求

需求
標頭 ntddscsi.h (包含 Ntddscsi.h)

另請參閱

SCSI_PASS_THROUGH