ERASE_BAND_PARAMETERS 構造体 (ehstorbandmgmt.h)

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

ERASE_BAND_PARAMETERS構造体には、消去するバンドの選択基準が含まれています。さらに、新しい認証キーを設定することもできます。この構造体は、 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 要求に対して入力されます。

構文

typedef struct _ERASE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;

メンバー

StructSize

この構造体のバイト単位のサイズ。 sizeof(ERASE_BAND_PARAMETERS) に設定します。

Flags

操作フラグを削除します。この値は、次のビットごとの OR の組み合わせです。

値	意味
ERASEBAND_AUTHKEY_CACHING_ENABLED	このバンドの新しい認証キーはキャッシュされ、後の操作を自動化できます。

Reserved

予約済み。

BandId

情報を返す 1 つのバンドの識別子。 BandId で 1 つのバンドが選択されている場合、BandSize は 0 である必要があります。BandId の代わりに BandStart と BandSize を使用してバンドを選択するには、BandId = (ULONG) –1 を設定します。

BandStart

バンド検索を開始するストレージデバイス上の開始バイト位置。 BandStart 以降でバンドとの一致が試行されます。

NewAuthKeyOffset

バンドの新しい承認キーを含む AUTH_KEY 構造体のオフセット (バイト単位)。オフセットは、 ERASE_BAND_PARAMETERSの先頭から取得されます。 AUTH_KEY は、 ehstorbandmgmt.h で次のように宣言されています。

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Key のキーデータのキーのサイズ (バイト単位)。 KeySize が 0 に設定されている場合は、既定のキーが使用されます。

キー

キーデータを含む可変長バイト配列。

既定の認証キーをバンドに指定するには、 NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEYを設定します。

注釈

バンド選択の優先順位は BandID に指定されます。 BandID が 0 より大きく、BandID が BAND_MANAGEMENT_CAPABILITIES の MaxBandCount メンバーより小さい場合、バンド一致の唯一の選択基準として BandID が使用されます。 BandID == –1 の場合、バンドを選択するための一致条件として BandStart が使用されます。いずれかの選択基準に一致するバンドがない場合は、IOCTL_EHSTOR_BANDMGMT_ERASE_BANDの IoStatus ブロックに STATUS_INVALID_PARAMETERが返されます。