次の方法で共有

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

  • [アーティクル]

バンドに関連付けられているメタデータは、 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 要求で取得されます。 バンドのメタデータは、キー マネージャー アプリケーションのデータ領域として機能します。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

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 を含む)

こちらもご覧ください

BAND_LOCATION_INFO

BAND_SECURITY_INFO

CREATE_BAND_PARAMETERS