STORAGE_REQUEST_BLOCK結構 (storport.h)

STORAGE_REQUEST_BLOCK是擴充格式的 SCSI 要求區塊 (SRB) 結構。 結構提供新增與SRB函式相關聯的擴充數據。

語法

typedef struct _STORAGE_REQUEST_BLOCK {
  USHORT                               Length;
  UCHAR                                Function;
  UCHAR                                SrbStatus;
  ULONG                                ReservedUlong1;
  ULONG                                Signature;
  ULONG                                Version;
  ULONG                                SrbLength;
  ULONG                                SrbFunction;
  ULONG                                SrbFlags;
  ULONG                                ReservedUlong2;
  ULONG                                RequestTag;
  USHORT                               RequestPriority;
  USHORT                               RequestAttribute;
  ULONG                                TimeOutValue;
  union {
    ULONG SystemStatus;
    ULONG RequestTagHigh4Bytes;
  } DUMMYUNIONNAME;
  ULONG                                SystemStatus;
  ULONG                                ZeroGuard1;
  ULONG                                AddressOffset;
  ULONG                                NumSrbExData;
  ULONG                                DataTransferLength;
  PVOID POINTER_ALIGN                  DataBuffer;
  PVOID POINTER_ALIGN                  ZeroGuard2;
  PVOID POINTER_ALIGN                  OriginalRequest;
  PVOID POINTER_ALIGN                  ClassContext;
  PVOID POINTER_ALIGN                  PortContext;
  PVOID POINTER_ALIGN                  MiniportContext;
  _STORAGE_REQUEST_BLOCK POINTER_ALIGN *NextSrb;
  struct                               _STORAGE_REQUEST_BLOCK;
  ULONG                                SrbExDataOffset[ANYSIZE_ARRAY];
} STORAGE_REQUEST_BLOCK, *PSTORAGE_REQUEST_BLOCK;

成員

Length

指定 SRB 標頭的大小，以便與 SCSI_REQUEST_BLOCK 結構相容。 這等於這個 結構的 Signature 成員位移。

Function

設定為 SRB_FUNCTION_STORAGE_REQUEST_BLOCK ，表示這是擴充的 SRB。 不同於 SCSI_REQUEST_BLOCK，SRB 函式標識符會改為位於 SrbFunction 成員中。

SrbStatus

傳回已完成要求的狀態。 此成員應該由迷你埠驅動程序設定，再通知操作系統特定的驅動程式，要求已完成，方法是呼叫 StorPortNotification with RequestComplete。 此成員的值可以是下列其中一項：

ReservedUlong1

保留的。 設定為 0。

Signature

擴充 SRB 格式的簽章。 這會設定為 SRB_SIGNATURE。

Version

所使用的結構版本。 目前的版本 是STORAGE_REQUEST_BLOCK_VERSION_1。

SrbLength

這個擴充 SRB 的長度，以位元組為單位，包括這個結構、位址和任何 SRB 擴充數據。

SrbFunction

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

SrbFlags

指出要求的各種參數和選項。 SrbFlags 是唯讀的，除非 設定SRB_FLAGS_UNSPECIFIED_DIRECTION ，而且需要次要 DMA 配接器的迷你埠驅動程式才能更新 SRB_FLAGS_DATA_IN 或 SRB_FLAGS_DATA_OUT。 此成員可以設定其中一或多個旗標。

ReservedUlong2

保留的。 設定為 0。

RequestTag

包含作業系統特定埠驅動程式指派的佇列標籤。 如果此成員用於標記的佇列，HBA 支援邏輯單元的內部佇列， (RU) ，而迷你埠驅動程式會在此 HBA 的PORT_CONFIGURATION_INFORMATION中將 TaggedQueueing 設定為 TRUE 。

RequestPriority

SRB 的優先順序指派。 可以是下列其中一個值。

RequestAttribute

指出設定 SRB_FLAGS_QUEUE_ACTION_ENABLE 旗標時要使用的標記佇列訊息。 此值可以是下列其中一項： SRB_SIMPLE_TAG_REQUEST、 SRB_HEAD_OF_QUEUE_TAG_REQUEST或 SRB_ORDERED_QUEUE_TAG_REQUEST。

TimeOutValue

指出要求可以在操作系統特定埠驅動程序視為逾時之前執行間隔，以秒為單位。小型埠驅動程式不需要時間要求，因為埠驅動程式已經這麼做。

DUMMYUNIONNAME

內嵌聯集。

DUMMYUNIONNAME.SystemStatus

用來將系統失敗狀態資訊儲存在 SrbStatus 失敗狀況中，例如 (SRB_STATUS_INTERNAL_ERROR) 。

DUMMYUNIONNAME.RequestTagHigh4Bytes

如果啟用唯一標籤功能，則用來儲存高四個字節的唯一標記。

SystemStatus

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

ZeroGuard1

保護區域，以防止將此結構解譯為 SCSI_REQUEST_BLOCK的驅動程式。 設定為 0。

AddressOffset

此結構開頭的記憶體要求位址位移。 此位移會尋找包含要求位址 的STOR_ADDRESS 結構。

NumSrbExData

此要求的擴充 SRB 數據區塊計數。

DataTransferLength

表示數據緩衝區的大小，以位元組為單位。 如果發生不足狀況，迷你埠驅動程序必須將此成員更新為實際傳輸的位元元組數目。

DataBuffer

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

ZeroGuard2

保護區域，以防止將此結構解譯為 SCSI_REQUEST_BLOCK的驅動程式。 設定為 0。

OriginalRequest

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

ClassContext

指向此要求的類別驅動程式內容數據。 此成員與迷你埠驅動程序無關。

PortContext

指向此要求的埠驅動程序內容數據。 此成員與迷你埠驅動程序無關。

MiniportContext

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

NextSrb

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

_STORAGE_REQUEST_BLOCK

SrbExDataOffset[ANYSIZE_ARRAY]

指定SRB擴充數據區塊位置的位移陣列。 如果 NumSrbExData = 0，則此陣列是空的。

備註

從 Windows 8 開始，使用 STORAGE_REQUEST_BLOCK 結構時，支援擴充 SRB 類型。 STORAGE_REQUEST_BLOCK 擴充 SRB 函式，允許將 SRB 函式的擴充數據區塊新增至要求。 使用 SCSI_REQUEST_BLOCK 結構的 SRB 要求支援將會繼續。

如果 NumSrbExData> 0，SRB 擴充數據區塊的位移會位於 SrbExDataOffset 陣列中。 每個位移都是相對於這個 結構的開頭，並指向包含擴充數據區塊 的SRBEX_DATA 結構。

SRB 的目標裝置位址位於 AddressOffset 所指示的STOR_ADDRESS結構中。

規格需求

另請參閱

• SCSI_REQUEST_BLOCK
• STOR_ADDRESS