IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
バンドに関連付けられているメタデータは、 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 要求で取得されます。 バンドのメタデータは、キー マネージャー アプリケーションのデータ領域として機能します。
メジャー コード
[入力バッファー]
Irp-AssociatedIrp.SystemBuffer の>入力バッファーには、GET_BAND_METADATA_PARAMETERS構造体が含まれている必要があります。
入力バッファーの長さ
Parameters.DeviceIoControl.InputBufferLength は、バッファーのサイズ (バイト単位) を示します。これは、少なくとも sizeof (GET_BAND_METADATA_PARAMETERS) である必要があります。
出力バッファー
Irp-AssociatedIrp.SystemBuffer の>出力バッファーには、GET_BAND_METADATA_PARAMETERSで指定されたバンド メタデータのバイト配列が含まれています。
出力バッファーの長さ
GET_BAND_METADATA_PARAMETERS構造体の長さ。
ステータス ブロック
[情報] フィールドには、出力バッファーに返されるバイト数が含まれます。 [状態] フィールドには、次のいずれかの値を返すことができます。
| 状態の値 | 説明 |
|---|---|
| STATUS_SUCCESS | メタデータがシステム バッファーに返されました。 |
| STATUS_INVALID_DEVICE_REQUEST | ストレージ デバイスは、バンド管理をサポートしていません。 |
| STATUS_INVALID_BUFFER_SIZE | 出力バッファーのサイズが正しくありません。 |
| STATUS_INVALID_PARAMETER | 入力バッファー内の情報が無効です。 |
| STATUS_NOT_FOUND | 指定された選択基準に対してバンドが見つかりませんでした。 |
| STATUS_IO_DEVICE_ERROR | 通信に失敗しました。 ストレージ デバイスがセキュリティ プロトコルと互換性がない可能性があります。 |
注釈
この IOCTL の認証は不要であり、認証キーは入力として含まれません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 以降で使用可能 |
| Header | ehstorbandmgmt.h (EhStorBandMgmt.h を含む) |