SET_BAND_METADATA_PARAMETERS構造体 (ehstorbandmgmt.h)
構成されたバンドのメタデータは、SET_BAND_METADATA_PARAMETERS 構造のパラメーターに設定されます。 この構造体は、IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 要求の入力です。
構文
typedef struct _SET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
ULONG BufferOffset;
ULONG AuthKeyOffset;
} SET_BAND_METADATA_PARAMETERS, *PSET_BAND_METADATA_PARAMETERS;
メンバーズ
StructSize
この構造体のサイズ (バイト単位)。 (SET_BAND_METADATA_PARAMETERS) のサイズをに設定します。
BandId
情報を返す 1 つのバンドの識別子。 BandSize は、BandId で 1 つのバンドが選択されている場合は 0 にする必要があります。 BandId の代わりに、BandStart と BandSize を使用してバンドを選択するには、BandId = (ULONG) –1 設定します。
BandStart
バンド検索を開始するストレージ デバイス上の開始バイト位置。 BandStart で、またはその後にバンド照合が試行されます。
MetadataOffset
新しいデータを設定するバンド メタデータ プロパティの先頭からのオフセット。
MetadataSize
設定するメタデータ バイトの長さ。 このサイズは、BAND_MANAGEMENT_CAPABILITIES 構造体の BandMetadataSize メンバーから減算 MetadataOffset の値によって制限されます。
BufferOffset
SET_BAND_METADATA_PARAMETERS の先頭から新しいメタデータの場所までのオフセット (バイト単位)。
AuthKeyOffset
バンドの承認キーを含む AUTH_KEY 構造体のオフセット (バイト単位)。 オフセットは、SET_BAND_METADATA_PARAMETERSの先頭から取得されます。 AUTH_KEY は、次のように ehstorbandmgmt.h で宣言されています。
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
KeySize
キーのキー データのキーのサイズ (バイト単位)。 KeySize が 0 に設定されている場合は、既定のキーが使用されます。
鍵
キー データを格納する可変長バイト配列。
既定の認証キーをバンドに指定するには、AuthKeyOffset = EHSTOR_BANDMGR_NO_KEYを設定します。
備考
バンド選択 BandID に優先順位が与えられる。 BandID が 0 より大きく、BandID が BAND_MANAGEMENT_CAPABILITIESの MaxBandCount メンバーより小さい場合、バンド一致の唯一の選択基準として、BandID が使用されます。 BandID == -1 の場合、バンド 選択する一致条件として BandStart が使用されます。 いずれかの選択基準に一致するバンドがない場合は、IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATAの IoStatus ブロックにSTATUS_INVALID_PARAMETERが返されます。
BandID と BandStart の両方が –1 に設定されている場合、IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA はグローバル バンドのメタデータを設定します。
バンド メタデータ ストアのサイズは、BAND_MANAGEMENT_CAPABILITIESの BandMetadataSize メンバーにあります。 この構造体は、IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES 要求から返されます。
バンドに設定する新しいメタデータは、IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 要求のシステム バッファーに含まれており、BufferOffset でこの構造従います。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 以降で使用可能 |
| ヘッダー | ehstorbandmgmt.h (EhStorBandMgmt.h を含む) |