共用方式為


SCSI_REQUEST_BLOCK 結構 (srb.h)

SCSI_REQUEST_BLOCK 結構與 SRB 函式相關聯。

注意

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

語法

typedef struct _SCSI_REQUEST_BLOCK {
  USHORT                     Length;
  UCHAR                      Function;
  UCHAR                      SrbStatus;
  UCHAR                      ScsiStatus;
  UCHAR                      PathId;
  UCHAR                      TargetId;
  UCHAR                      Lun;
  UCHAR                      QueueTag;
  UCHAR                      QueueAction;
  UCHAR                      CdbLength;
  UCHAR                      SenseInfoBufferLength;
  ULONG                      SrbFlags;
  ULONG                      DataTransferLength;
  ULONG                      TimeOutValue;
  PVOID                      DataBuffer;
  PVOID                      SenseInfoBuffer;
  struct _SCSI_REQUEST_BLOCK *NextSrb;
  PVOID                      OriginalRequest;
  PVOID                      SrbExtension;
  union {
    ULONG InternalStatus;
    ULONG QueueSortKey;
    ULONG LinkTimeoutValue;
  };
  ULONG                      Reserved;
  UCHAR                      Cdb[16];
} SCSI_REQUEST_BLOCK, *PSCSI_REQUEST_BLOCK;

成員

Length

指定這個結構位元組的大小。

Function

指定要執行的作業,它可以是下列其中一個值:

作業
SRB_FUNCTION_EXECUTE_SCSI (0x00) 應在目標邏輯單元上執行 SCSI 裝置 I/O 要求。
SRB_FUNCTION_ABORT_COMMAND (0x10) 應該傳送SCSIMESS_ABORT訊息,以取消 NextSrb 成員所指向的要求。 如果這是標記佇列要求,則應該改用SCSIMESS_ABORT_WITH_TAG訊息。 如果指定的要求已完成,則應該正常完成此要求。 只有 SRB 函式PathId、TargetIdLunNextSrb 成員有效。
SRB_FUNCTION_RESET_DEVICE (0x13) ScsiPort 驅動程式不再將此 SRB 傳送至其迷你埠。 只有 Storport 迷你埠驅動程式會使用此 SRB。 應該使用SCSIMESS_BUS_DEVICE_RESET訊息來重設 SCSI 目標控制器。 迷你埠驅動程序應該完成目標控制器的任何作用中要求。 只有 SRB 函式TargetIdPathId 成員有效。
SRB_FUNCTION_RESET_LOGICAL_UNIT (0x20) 如果可能的話,應該重設邏輯單元。 HBA 迷你埠驅動程序應該完成邏輯單元的任何作用中要求。 只有 SRB 的 FunctionPathId、TargetIdLun 成員有效。 Storport 支援這種類型的重設,但 SCSI 埠則不支援。
SRB_FUNCTION_RESET_BUS (0x12) 應該使用SCSIMESS_BUS_DEVICE_RESET訊息來重設 SCSI 總線。 迷你埠驅動程式只有在指定的要求逾時,以及後續中止逾時要求時,才會收到此要求。只有 SRB 函式PathId 成員有效。
SRB_FUNCTION_TERMINATE_IO (0x14) 應該傳送SCSIMESS_TERMINATE_IO_PROCESS訊息,以取消 NextSrb 成員所指向的要求。 如果指定的要求已經完成,則應該正常完成此要求。 只有 SRB 函式PathId、TargetIdLunNextSrb 成員有效。
SRB_FUNCTION_RELEASE_RECOVERY (0x11) SCSIMESS_RELEASE_RECOVERY訊息應該傳送至目標控制器。 只有 SRB 函式PathIdTargetIdLun 成員有效。
SRB_FUNCTION_RECEIVE_EVENT (0x03) HBA 應該準備好從尋址的目標接收異步事件通知。 SRB DataBuffer 成員會指出應該放置數據的位置。
SRB_FUNCTION_SHUTDOWN (0x07) 系統正在關閉。 只有在 HBA 的 PORT_CONFIGURATION_INFORMATION中將 CachesData 設定為 TRUE 時,才會將此要求傳送至迷你埠驅動程式。 這類迷你埠驅動程式可以在所有系統活動實際停止之前,接收其中數個通知。 不過,最後一個關機通知會在上次啟動 I/O 之後發生。 只有 SRB 函式PathId、TargetIdLun 成員有效。
SRB_FUNCTION_FLUSH (0x08) 迷你埠驅動程序應該排清目標裝置的任何快取數據。 只有在 HBA 的 PORT_CONFIGURATION_INFORMATION中將 CachesData 設定為 TRUE 時,才會將此要求傳送至迷你埠驅動程式。 只有 SRB 函式PathId、TargetIdLun 成員有效。
SRB_FUNCTION_IO_CONTROL (0x02) 要求是 I/O 控制件要求,源自具有專用 HBA 的使用者模式應用程式。 SRB DataBuffer 指向SRB_IO_CONTROL標頭,後面接著數據區域。 不論 MapBuffers 的值為何,驅動程式都可以使用 DataBuffer 中的值。 如果迷你埠驅動程式在初始化時要求 SRB 擴充功能,則只有 SRB 函式、SrbFlagsTimeOutValueDataBufferDataTransferLength 成員是有效的,以及 SrbExtension 成員。 如果迷你埠驅動程式控制應用程式專用 HBA 以支援此要求,迷你埠驅動程式應該執行要求,並在 SRB 完成時通知 OS 特定的埠驅動程式,並使用使用 RequestCompleteNextRequest 呼叫 ScsiPortNotification 的一般機制。
SRB_FUNCTION_LOCK_QUEUE (0x18) 保存埠驅動程式針對特定邏輯單元排入佇列的要求,通常是在處理電源要求時。 只有 SRB LengthFunctionSrbFlagsOriginalRequest 成員有效。 鎖定佇列時,只會處理具有 SrbFlags ORed SRB_FLAGS_BYPASS_LOCKED_QUEUE的要求。 SCSI 迷你埠驅動程式不會處理SRB_FUNCTION_LOCK_QUEUE要求。
SRB_FUNCTION_UNLOCK_QUEUE (0x19) 釋放先前使用 SRB_FUNCTION_LOCK_QUEUE 鎖定之邏輯單元的埠驅動程式佇列。 解除鎖定要求的 SrbFlags 必須是具有 SRB_FLAGS_BYPASS_LOCKED_QUEUE 的 ORed。 只有 SRB LengthFunctionSrbFlagsOriginalRequest 成員有效。 SCSI 迷你埠驅動程式不會處理SRB_FUNCTION_UNLOCK_QUEUE要求。
SRB_FUNCTION_UNLOCK_QUEUE (0x19) 釋放先前使用 SRB_FUNCTION_LOCK_QUEUE 鎖定之邏輯單元的埠驅動程式佇列。 解除鎖定要求的 SrbFlags 必須是具有 SRB_FLAGS_BYPASS_LOCKED_QUEUE 的 ORed。 只有 SRB LengthFunctionSrbFlagsOriginalRequest 成員有效。 SCSI 迷你埠驅動程式不會處理SRB_FUNCTION_UNLOCK_QUEUE要求。
SRB_FUNCTION_DUMP_POINTERS (0x26) 具有此函式的要求會傳送至 Storport 迷你埠驅動程式,用來控制保存損毀傾印數據的磁碟。 要求會收集迷你埠驅動程式所需的資訊,以支援損毀傾印和休眠。 請參閱 MINIPORT_DUMP_POINTERS 結構。 實體迷你埠驅動程序必須在其HW_INITIALIZATION_DATA的FeatureSupport成員中設定STOR_FEATURE_DUMP_POINTERS旗標,才能接收具有此函式的要求。
SRB_FUNCTION_FREE_DUMP_POINTERS (0x27) 具有此函式的要求會傳送至 Storport 迷你埠驅動程式,以釋放先前要求期間針對 SRB_FUNCTION_DUMP_POINTERS 配置的任何資源。

SrbStatus

傳回已完成要求的狀態。 此成員應該先由迷你埠驅動程序設定,再通知 OS 特定驅動程式要求已完成,方法是使用 RequestComplete 呼叫 ScsiPortNotification。 這個成員的值可以是下列其中一項:

意義
SRB_STATUS_PENDING 表示要求正在進行中。 OS 特定的埠驅動程式會將 SrbStatus 初始化為此值。
SRB_STATUS_SUCCESS 指出要求已順利完成。
SRB_STATUS_ABORTED 表示要求已中止,如埠驅動程式指示。 迷你埠驅動程式會在 NextSrb 中設定此狀態,以取得成功的SRB_FUNCTION_ABORT_COMMAND要求。
SRB_STATUS_ABORT_FAILED 表示嘗試中止要求失敗。 當找不到指定的要求時,傳回SRB_FUNCTION_ABORT_COMMAND要求的這個狀態。
SRB_STATUS_ERROR 指出要求已完成,並出現SCSI總線狀態的錯誤。
SRB_STATUS_BUSY 表示迷你埠驅動程式或目標裝置目前無法接受要求。 OS 特定的埠驅動程式稍後會重新提交要求。
SRB_STATUS_INTERNAL_ERROR 指出 SCSI 埠驅動程式無法將要求傳遞至迷你埠驅動程式或目標裝置。 在這種情況下,狀態會記錄在 InternalStatus 中。
SRB_STATUS_INVALID_REQUEST 表示迷你埠驅動程序不支援指定的要求。
SRB_STATUS_NO_DEVICE 表示裝置未回應。
SRB_STATUS_TIMEOUT 表示要求逾時。
SRB_STATUS_SELECTION_TIMEOUT 指出 SCSI 裝置選取已逾時。
SRB_STATUS_COMMAND_TIMEOUT 表示目標未在時間限制內完成命令。
SRB_STATUS_MESSAGE_REJECTED 表示目標已拒絕訊息。 這通常只會針對這類訊息類型要求傳回,例如 SRB_FUNCTION_TERMINATE_IO。
SRB_STATUS_BUS_RESET 指出執行此要求時發生總線重設。
SRB_STATUS_PARITY_ERROR 指出 SCSI 總線上發生同位錯誤,且重試失敗。
SRB_STATUS_REQUEST_SENSE_FAILED 表示要求感知命令失敗。 只有在 HBA 執行自動要求感知,而迷你埠驅動程式在此 HBA 的PORT_CONFIGURATION_INFORMATION中將 AutoRequestSense 設定為 TRUE 時,才會傳回此功能。
SRB_STATUS_NO_HBA 表示 HBA 沒有回應。
SRB_STATUS_DATA_OVERRUN 表示發生數據滿溢或不足錯誤。 迷你埠驅動程式也必須更新 SRB 的 DataTransferLength 成員,以指出發生不足時實際傳輸的數據量。
SRB_STATUS_UNEXPECTED_BUS_FREE 表示目標意外中斷連線。
SRB_STATUS_PHASE_SEQUENCE_FAILURE 表示 HBA 偵測到不合法的階段順序失敗錯誤。
SRB_STATUS_REQUEST_FLUSHED 指出狀態的要求已停止。
SRB_STATUS_BAD_FUNCTION 表示不支援 SRB 函式 程式碼。
SRB_STATUS_INVALID_PATH_ID 指出 SRB 中指定的 PathId 不存在。
SRB_STATUS_INVALID_TARGET_ID 表示 SRB 中的 TargetID 值無效。
SRB_STATUS_INVALID_LUN 表示 SRB 中的 Lun 值無效。
SRB_STATUS_ERROR_RECOVERY 指出要求已完成,並出現 SCSI 總線狀態錯誤,並收到 SCSI 起始復原訊息。
SRB_STATUS_AUTOSENSE_VALID 指出 SenseInfoBuffer 中傳回的資訊有效。
SRB_STATUS_QUEUE_FROZEN 迷你埠驅動程式 不應SrbStatus 成員設定為此值。 Windows 連接埠驅動程式可以設定此值,通知記憶體類別驅動程式其特定周邊的要求佇列已凍結。

ScsiStatus

傳回 HBA 或目標裝置所傳回的 SCSI 狀態。 如果狀態不是 SUCCESS,迷你埠驅動程式應該將 SrbStatus 成員設定為 SRB_STATUS_ERROR。

PathId

指出要求的 SCSI 埠或總線。 這個值是以零起始。

TargetId

指出總線上的目標控制器或裝置。

Lun

指出裝置的邏輯單元編號。

QueueTag

包含 OS 特定埠驅動程式指派的佇列標籤。 如果這個成員用於標記的佇列,HBA 支援對 RU 的要求內部佇列,而迷你埠驅動程式會在此 HBA 的PORT_CONFIGURATION_INFORMATION中將 TaggedQueueing 設定為 TRUE

QueueAction

指出設定SRB_FLAGS_QUEUE_ACTION_ENABLE旗標時要使用的標記佇列訊息。 此值可以是下列其中一項:SRB_SIMPLE_TAG_REQUEST、SRB_HEAD_OF_QUEUE_TAG_REQUEST或SRB_ORDERED_QUEUE_TAG_REQUEST,如 SCSI 規格所定義。

CdbLength

指出 SCSI-2 或更新版本命令描述元區塊的大小以位元組為單位。

SenseInfoBufferLength

表示要求感知緩衝區的位元組大小。 如果發生下限,迷你埠驅動程序必須將此成員更新為實際傳輸的位元元組數目。

SrbFlags

指出要求的各種參數和選項。 SrbFlags 是唯讀的,除非設定SRB_FLAGS_UNSPECIFIED_DIRECTION,而次級 DMA 適配卡的迷你埠驅動程式則需要更新SRB_FLAGS_DATA_IN或SRB_FLAGS_DATA_OUT。 此成員可以設定下列一或多個旗標:

旗標 意義
SRB_FLAGS_QUEUE_ACTION_ENABLE 指出要啟用標記佇列動作。
SRB_FLAGS_DISABLE_AUTOSENSE 表示不應該傳回要求感知資訊。
SRB_FLAGS_DATA_IN 指出數據會從裝置傳輸到系統。
SRB_FLAGS_DATA_OUT 表示數據會從系統傳輸到裝置。
SRB_FLAGS_UNSPECIFIED_DIRECTION 針對與 ASPI/CAM SCSI 介面的回溯相容性所定義,此旗標表示傳輸方向可能是上述其中一個,因為已設定上述兩個旗標。 如果設定此旗標,迷你埠驅動程序應該檢查 SCSI 總線上目標的數據階段來判斷傳輸方向。 如果 HBA 是次級 DMA 裝置,這類迷你埠驅動程序必須先將SRB_FLAGS_DATA_OUT或SRB_FLAGS_DATA_IN更新為正確的值,才能呼叫 ScsiPortIoMapTransfer
SRB_FLAGS_NO_DATA_TRANSFER 表示此要求沒有數據傳輸。 如果已設定,則會清除旗標SRB_FLAGS_DATA_OUT、SRB_FLAGS_DATA_IN和SRB_FLAGS_UNSPECIFIED_DIRECTION。
SRB_FLAGS_DISABLE_SYNCH_TRANSFER 如果可能的話,表示 HBA 應該針對此傳輸要求執行異步 I/O。 如果先前已交涉同步 I/O,則 HBA 必須先重新交涉異步 I/O,才能執行傳輸。
SRB_FLAGS_DISABLE_DISCONNECT 表示 HBA 不應允許目標在處理此要求期間中斷與 SCSI 總線的連線。
SRB_FLAGS_BYPASS_FROZEN_QUEUE 與迷你埠驅動程序無關。
SRB_FLAGS_NO_QUEUE_FREEZE 與迷你埠驅動程序無關。
SRB_FLAGS_IS_ACTIVE 與迷你埠驅動程序無關。
SRB_FLAGS_ALLOCATED_FROM_ZONE 與迷你埠驅動程序無關,目前 Windows 類別驅動程式已過時。 對於 Windows 舊版類別驅動程式,這表示 SRB 是否從區域緩衝區配置。 如果設定此旗標,類別驅動程序必須呼叫 ExInterlockedFreeToZone 以釋放 SRB;否則,它必須呼叫 ExFreePool。 新的類別驅動程式應該使用 lookaside 清單,而不是區域緩衝區。
SRB_FLAGS_SGLIST_FROM_POOL 與迷你埠驅動程序無關。 針對 Windows 類別驅動程式,這表示散佈/收集清單的記憶體是從非分頁集區配置。 如果已設定此旗標,類別驅動程式必須呼叫 ExFreePool ,以在 SRB 完成之後釋放記憶體。
SRB_FLAGS_BYPASS_LOCKED_QUEUE 與迷你埠驅動程序無關。 在埠驅動程式中,此旗標表示是否應該處理要求是否鎖定邏輯單元佇列。 較高層級的驅動程序必須設定此旗標,才能傳送SRB_FUNCTION_UNLOCK_QUEUE要求。
SRB_FLAGS_NO_KEEP_AWAKE 與迷你埠驅動程序無關。 Windows 類別驅動程式會使用此旗標向埠驅動程式指出要回報閑置,而不是啟動裝置來處理此要求。
SRB_FLAGS_FREE_SENSE_BUFFER 表示埠或迷你埠驅動程式已為感知數據配置緩衝區。 這會通知類別驅動程式,在擷取數據之後,它必須釋放感知數據緩衝區。

DataTransferLength

指出數據緩衝區位元組的大小。 如果發生下限,迷你埠驅動程序必須將此成員更新為實際傳輸的位元元組數目。

TimeOutValue

指出要求可以在OS特定埠驅動程式視為逾時之前的秒內執行間隔。因為埠驅動程式已經執行,所以不需要迷你埠驅動程式才能進行時間要求。

DataBuffer

指向數據緩衝區。 除非迷你埠驅動程式在 HBA 的PORT_CONFIGURATION_INFORMATION中將 MapBuffers 設定為 TRUE ,否則不應使用此值作為數據指標。 不過,在SRB_FUNCTION_IO_CONTROL要求的情況下,迷你埠驅動程式可以使用此值作為數據指標,而不論 MapBuffers 的值為何。

SenseInfoBuffer

指向要求感知緩衝區。 不需要迷你埠驅動程式,才能在 CHECK CONDITION 之後提供要求感知數據。

NextSrb

指出套用此要求SCSI_REQUEST_BLOCK。 只有一小部分的要求會使用第二個 SRB,例如SRB_FUNCTION_ABORT_COMMAND。

OriginalRequest

指向此要求的 IRP。 此成員與迷你埠驅動程序無關

SrbExtension

指向 Srb 延伸模組。 如果迷你埠驅動程式在SCSI_HW_INITIALIZATION_DATA中將 SrbExtensionSize 設定為零,則不得使用此成員。 SrbExtension 上的記憶體不會由 OS 特定的埠驅動程式初始化,而迷你埠驅動程式決定的數據可以直接由 HBA 存取。 您可以使用 SrbExtension 指標呼叫 ScsiPortGetPhysicalAddress 來取得對應的實體位址。

InternalStatus

當要求無法傳遞至迷你埠驅動程式時,SCSI 埠驅動程式會使用,而不是 SrbStatus 來報告已完成要求的狀態。 在這種情況下, SrbStatus 會設定為 SRB_STATUS_INTERNAL_ERROR。 此成員專用於 SCSI 埠與類別驅動程式之間的通訊,而且不應該供迷你埠驅動程式使用。

QueueSortKey

根據目標裝置的類型,指定媒體開頭或零的位移。

LinkTimeoutValue

連結逾時值。

Reserved

保留的。

Cdb[16]

指定要傳送至目標裝置的 SCSI-2 或更新版本命令描述元區塊。

備註

Windows 記憶體類別和篩選驅動程式可以將具有下列 函式 值的 SRB 傳送至系統埠驅動程式:

  • SRB_FUNCTION_CLAIM_DEVICE,指出類別驅動程序支援 PathIdTargetId和 Lun成員在SRB中識別的 周邊
  • SRB_ATTACH_DEVICE表示篩選驅動程式分層在類別驅動程式上方,希望先將特定周邊的要求路由傳送至篩選驅動程式。
  • SRB_FUNCTION_RELEASE_DEVICE,指出類別驅動程式正在特定周邊上釋放其宣告。
  • SRB_FUNCTION_FLUSH_QUEUE要求取消埠驅動程式中目前排入佇列的任何要求至特定周邊。
  • SRB_FUNCTION_RELEASE_QUEUE要求埠驅動程式將要求凍結的佇列釋出至特定周邊的要求。

上述SRB_FUNCTION_XXX 永遠不會在傳送至SCSI迷你埠驅動程式的SRB中設定。 SRB_FUNCTION_REMOVE_DEVICE已定義以供未來版本的系統使用。 此外,也不會在傳送至 SCSI 迷你埠驅動程式的 SRB 中設定。 SRB_FUNCTION_WMI_REQUEST僅適用於 SCSI_WMI_REQUEST_BLOCK。 記憶體類別或篩選驅動程式會使用此屬性將 WMI 要求傳送至埠驅動程式。

規格需求

需求
標頭 srb.h (包括 Srb.h、Minitape.h、Storport.h)

另請參閱

ExFreePool

ExInterlockedFreeToZone

HW_INITIALIZATION_DATA (SCSI)

PORT_CONFIGURATION_INFORMATION (SCSI)

SCSI_WMI_REQUEST_BLOCK

SRB_IO_CONTROL

ScsiPortGetPhysicalAddress

ScsiPortGetSrb

ScsiPortIoMapTransfer

ScsiPortNotification