STORAGE_ADAPTER_DESCRIPTOR構造体 (winioctl.h)

[アーティクル]
08/27/2023

IOCTL_STORAGE_QUERY_PROPERTY 制御コードと組み合わせて使用して、デバイスのストレージアダプター記述子データを取得します。

構文

typedef struct _STORAGE_ADAPTER_DESCRIPTOR {
  DWORD   Version;
  DWORD   Size;
  DWORD   MaximumTransferLength;
  DWORD   MaximumPhysicalPages;
  DWORD   AlignmentMask;
  BOOLEAN AdapterUsesPio;
  BOOLEAN AdapterScansDown;
  BOOLEAN CommandQueueing;
  BOOLEAN AcceleratedTransfer;
#if ...
  BOOLEAN BusType;
#else
  BYTE    BusType;
#endif
  WORD    BusMajorVersion;
  WORD    BusMinorVersion;
  BYTE    SrbType;
  BYTE    AddressType;
} STORAGE_ADAPTER_DESCRIPTOR, *PSTORAGE_ADAPTER_DESCRIPTOR;

メンバー

Version

この構造体のサイズをバイト単位で格納します。構造体にメンバーが追加されると、このメンバーの値が変更されます。

Size

返されるデータの合計サイズをバイト単位で指定します。これには、この構造に続くデータが含まれる場合があります。

MaximumTransferLength

ストレージアダプターが 1 回の操作で転送できる最大バイト数を指定します。

MaximumPhysicalPages

記憶域アダプターが 1 回の転送で管理できる不連続な物理ページの最大数を指定します (つまり、散布/収集サポートの範囲)。

AlignmentMask

転送の記憶域アダプターの配置要件を指定します。アラインメントマスクは、転送操作にストレージアダプターが必要とするバッファーのアラインメント制限を示します。有効なマスク値は、Windows のさまざまなバージョンのメモリマネージャーの特性によっても制限されます。

値	意味
0	バッファーは BYTE 境界に配置する必要があります。
1	バッファーは WORD の境界に配置する必要があります。
3	バッファーは、 DWORD32 境界に配置する必要があります。
7	バッファーは、 DWORD64 境界に配置する必要があります。

AdapterUsesPio

このメンバーが TRUE の場合、ストレージアダプターはプログラムされた I/O (PIO) を使用し、データバッファーの物理メモリにマップされたシステム空間仮想アドレスを使用する必要があります。このメンバーが FALSE の場合、ストレージアダプターは PIO を使用しません。

AdapterScansDown

このメンバーが TRUE の場合、ストレージアダプターは BIOS デバイスをスキャンします。つまり、ストレージアダプターは、最も低いデバイス番号ではなく、最も大きいデバイス番号でスキャンを開始します。このメンバーが FALSE の場合、ストレージアダプターはデバイス番号が最も小さい状態でスキャンを開始します。このメンバーは、レガシミニポートドライバー用に予約されています。

CommandQueueing

このメンバーが TRUE の場合、ストレージアダプターは SCSI タグ付きキューや論理ユニットごとの内部キュー、または非 SCSI 同等のキューをサポートします。このメンバーが FALSE の場合、ストレージアダプターは SCSI タグ付きキューも論理ユニットごとの内部キューもサポートしません。

AcceleratedTransfer

このメンバーが TRUE の場合、ストレージアダプターは I/O を高速化する方法として同期転送をサポートします。このメンバーが FALSE の場合、ストレージアダプターは I/O を高速化する方法として同期転送をサポートしません。

BusType

デバイスが接続されているバスの種類を示す STORAGE_BUS_TYPE 型の値を指定します。

BusMajorVersion

ストレージアダプターのメジャーバージョン番号 (存在する場合) を指定します。

BusMinorVersion

ストレージアダプターのマイナーバージョン番号 (存在する場合) を指定します。

SrbType

HBA で使用される SCSI 要求ブロック (SRB) の種類を指定します。

値	意味
SRB_TYPE_SCSI_REQUEST_BLOCK	HBA は SCSI 要求ブロックを使用します。
SRB_TYPE_STORAGE_REQUEST_BLOCK	HBA は拡張 SCSI 要求ブロックを使用します。

このメンバーは、Windows 8 以降で有効です。

AddressType

HBA のアドレスの種類を指定します。

値	意味
STORAGE_ADDRESS_TYPE_BTL8	HBA では、8 ビットのバス、ターゲット、LUN のアドレス指定が使用されます。

このメンバーは、Windows 8 以降で有効です。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	winioctl.h (Windows.h を含む)

次の方法で共有

STORAGE_ADAPTER_DESCRIPTOR構造体 (winioctl.h)

構文

メンバー

要件

関連項目

フィードバック

その他のリソース