SCSI_REQUEST_BLOCK 構造体 (srb.h)

SCSI_REQUEST_BLOCK構造体は SRB 関数に関連付けられています。

構文

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

実行する操作を指定します。次のいずれかの値を指定できます。

SrbStatus

完了した要求の状態を返します。 このメンバーは、要求が完了したことを OS 固有のドライバーに通知する前に、ミニポート ドライバーによって設定する必要があります ScsiPortNotification with RequestComplete します。 このメンバーの値は、次のいずれかになります。

ScsiStatus

HBA またはターゲット デバイスによって返された SCSI 状態を返します。 状態が SUCCESS でない場合、ミニポート ドライバーは SrbStatus メンバーをSRB_STATUS_ERRORに設定する必要があります。

PathId

要求の SCSI ポートまたはバスを示します。 この値は 0 から始まります。

TargetId

バス上のターゲット コントローラーまたはデバイスを示します。

Lun

デバイスの論理ユニット番号を示します。

QueueTag

OS 固有のポート ドライバーによって割り当てられたキュー タグ値を格納します。 このメンバーがタグ付きキューに使用されている場合、HBA は LU への要求の内部キューをサポートし、ミニポート ドライバーは、この HBA のPORT_CONFIGURATION_INFORMATIONで TaggedQueueing を TRUE に設定します。

QueueAction

SRB_FLAGS_QUEUE_ACTION_ENABLE フラグが設定されている場合に使用されるタグ付きキュー メッセージを示します。 値には、SCSI 仕様に従って定義されているSRB_SIMPLE_TAG_REQUEST、SRB_HEAD_OF_QUEUE_TAG_REQUEST、またはSRB_ORDERED_QUEUE_TAG_REQUESTのいずれかを指定できます。

CdbLength

SCSI-2 以降のコマンド記述子ブロックのサイズをバイト単位で示します。

SenseInfoBufferLength

要求センス バッファーのサイズをバイト単位で示します。 アンダーランが発生した場合、ミニポート ドライバーは、実際に転送されたバイト数にこのメンバーを更新する必要があります。

SrbFlags

要求に関するさまざまなパラメーターとオプションを示します。 SrbFlags は読み取り専用です。ただし、SRB_FLAGS_UNSPECIFIED_DIRECTIONが設定されていて、SRB_FLAGS_DATA_INまたはSRB_FLAGS_DATA_OUTを更新するために下位 DMA アダプターのミニポート ドライバーが必要な場合を除きます。 このメンバーには、次のフラグを 1 つ以上設定できます。

DataTransferLength

データ バッファーのサイズをバイト単位で示します。 アンダーランが発生した場合、ミニポート ドライバーは、実際に転送されたバイト数にこのメンバーを更新する必要があります。

TimeOutValue

OS 固有のポート ドライバーがタイムアウトしたと見なす前に、要求が実行できる間隔を秒単位で示します。ミニポート ドライバーは、ポート ドライバーが既に行うので、要求を時間を取る必要はありません。

DataBuffer

データ バッファーを指します。 ミニポート ドライバーは、ミニポート ドライバーが HBA のPORT_CONFIGURATION_INFORMATIONで MapBuffers を TRUE に設定しない限り、データ ポインターとしてこの値を使用しないでください。 ただし、SRB_FUNCTION_IO_CONTROL要求の場合、ミニポート ドライバーは MapBuffers の値に関係なく、この値をデータ ポインターとして使用できます。

SenseInfoBuffer

要求センス バッファーを指します。 ミニポート ドライバーは、CHECK 条件の後に要求検出データを提供する必要はありません。

NextSrb

この要求が適用されるSCSI_REQUEST_BLOCKを示します。 SRB_FUNCTION_ABORT_COMMANDなど、2 番目の SRB を使用するのは、要求の小さなサブセットのみです。

OriginalRequest

この要求の IRP を指します。 このメンバーはミニポート ドライバーとは無関係です

SrbExtension

Srb 拡張を指します。 ミニポート ドライバーは、 SCSI_HW_INITIALIZATION_DATAで SrbExtensionSize を 0 に設定する場合、このメンバーを使用しないでください。 SrbExtension のメモリは OS 固有のポート ドライバーによって初期化されず、ミニポート ドライバーによって決定されたデータは HBA によって直接アクセスできます。 対応する物理アドレスは、SrbExtension ポインターを使用して ScsiPortGetPhysicalAddress を呼び出すことによって取得できます。

InternalStatus

要求をミニポート ドライバーに配信できない場合は常に完了した要求の状態を報告するために、 SrbStatus の代わりに SCSI ポート ドライバーによって使用されます。 このような場合、 SrbStatus は SRB_STATUS_INTERNAL_ERROR に設定されます。 このメンバーは、SCSI ポートとクラス ドライバー間の通信にのみ使用され、ミニポート ドライバーでは使用しないでください。

QueueSortKey

ターゲット デバイスの種類に応じて、メディアの先頭から 0 のオフセットを指定します。

LinkTimeoutValue

リンク タイムアウト値。

Reserved

予約済み。

Cdb[16]

ターゲット デバイスに送信する SCSI-2 以降のコマンド記述子ブロックを指定します。

注釈

Windows ストレージ クラスとフィルター ドライバーは、次の Function 値を持つ SRB をシステム ポート ドライバーに送信できます。

• SRB_FUNCTION_CLAIM_DEVICE、クラス ドライバーが PathId、 TargetId、 および 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 要求をポート ドライバーに送信します。

要件

こちらもご覧ください

ExFreePool

ExInterlockedFreeToZone

HW_INITIALIZATION_DATA (SCSI)

PORT_CONFIGURATION_INFORMATION (SCSI)

SCSI_WMI_REQUEST_BLOCK

SRB_IO_CONTROL

ScsiPortGetPhysicalAddress

ScsiPortGetSrb

ScsiPortIoMapTransfer

ScsiPortNotification