SCSI_PASS_THROUGH 構造体 (ntddscsi.h)

[アーティクル]
03/05/2024

SCSI_PASS_THROUGH構造体は、埋め込み SCSI コマンドをターゲットデバイスに送信するようにポートドライバーに指示する IOCTL_SCSI_PASS_THROUGH 要求と組み合わせて使用されます。

メモ SCSI ポートドライバーと SCSI ミニポートドライバーモデルは、今後変更または使用できない可能性があります。代わりに、 Storport ドライバーと Storport ミニポートドライバーモデルを使用することをお勧めします。

構文

typedef struct _SCSI_PASS_THROUGH {
  USHORT    Length;
  UCHAR     ScsiStatus;
  UCHAR     PathId;
  UCHAR     TargetId;
  UCHAR     Lun;
  UCHAR     CdbLength;
  UCHAR     SenseInfoLength;
  UCHAR     DataIn;
  ULONG     DataTransferLength;
  ULONG     TimeOutValue;
  ULONG_PTR DataBufferOffset;
  ULONG     SenseInfoOffset;
  UCHAR     Cdb[16];
} SCSI_PASS_THROUGH, *PSCSI_PASS_THROUGH;

メンバー

Length

sizeof(SCSI_PASS_THROUGH) の値を格納します。

ScsiStatus

HBA またはターゲットデバイスによって返された SCSI 状態を報告します。

PathId

要求の SCSI ポートまたはバスを示します。

TargetId

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

Lun

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

CdbLength

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

SenseInfoLength

要求センスバッファーのサイズをバイト単位で示します。

DataIn

このフィールドには、次の 3 つの値のいずれかが必要です。

#######

DataTransferLength

データバッファーのサイズをバイト単位で示します。多くのデバイスは、定義済みの長さのデータのチャンクを転送します。 DataTransferLength の値は、デバイスで指定される、この定義済みの最小長の整数倍数である必要があります。アンダーランが発生した場合、ミニポートドライバーは、実際に転送されたバイト数にこのメンバーを更新する必要があります。

TimeOutValue

ポートドライバーがタイムアウトしたと見なす前に、要求が実行できる間隔を秒単位で示します。

DataBufferOffset

この構造体の先頭からデータバッファーへのオフセットが含まれます。オフセットは、デバイスのデータアラインメント要件を考慮する必要があります。

SenseInfoOffset

この構造体の先頭から要求センスバッファーへのオフセット。

Cdb[16]

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

注釈

SCSI_PASS_THROUGH構造体は、バッファーに格納されたデバイス制御要求である IOCTL_SCSI_PASS_THROUGH で使用されます。システムメモリのバッファリングをバイパスするには、呼び出し元は IOCTL_SCSI_PASS_THROUGH_DIRECT を使用する必要があります。 IOCTL_SCSI_PASS_THROUGH_DIRECT要求を処理すると、システムはユーザーメモリ内のバッファーをロックダウンし、デバイスはこのメモリに直接アクセスします。

SCSI_PASS_THROUGHのメンバーは、 SCSI_REQUEST_BLOCK 構造体のメンバーとほぼ同じです。 DataIn メンバーの値は、SCSI_REQUEST_BLOCKの SrbFlags メンバーに割り当てられたSCSI_IOCTL_DATA_IN、SCSI_IOCTL_DATA_OUT、およびSCSI_IOCTL_DATA_UNSPECIFIEDフラグに対応します。