ENUMERATE_BANDS_PARAMETERS 構造体 (ehstorbandmgmt.h)

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

ENUMERATE_BANDS_PARAMETERS構造体は、IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS要求から返すために選択されるバンド情報エントリを選択するために使用されます。

構文

typedef struct _ENUMERATE_BANDS_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  LARGE_INTEGER BandSize;
} ENUMERATE_BANDS_PARAMETERS, *PENUMERATE_BANDS_PARAMETERS;

メンバー

StructSize

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

Flags

バンド列挙フラグ。この値は、次のビットごとの OR の組み合わせです。

値	意味
ENUMBANDS_ENUM_ALL_BANDS	すべてのバンドが返されます。このフラグを設定すると、 BandId、 BandStart、および BandSize メンバーは無視されます。
ENUMBANDS_REPORT_CRYPTO_ALGO	BAND_TABLE_ENTRYの SecurityInfo メンバーにメディア暗号化アルゴリズム情報を含めます。

Reserved

予約済み。

BandId

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

BandStart

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

BandSize

オプションのバンドサイズの一致値 (バイト単位)。 BandSize == 0 と BandId == –1 の場合、バンドを選択するための唯一の一致値は BandStart になります。それ以外の場合は、 BandStart 以降のバンドと、一致する BandSize が正確に選択されます。

注釈

フラグでENUMBANDS_ENUM_ALL_BANDSが設定されていない場合は、1 つのバンドに一致するように選択が試行されます。バンド一致は、 BandID、 BandStart、 BandSize の値に基づいて行われます。バンド選択の場合は 、BandID に優先順位が設定されます。 BandID> 0 と BandID<MaxBandCount メンバーが BAND_MANAGEMENT_CAPABILITIESBandID が 0 より大きく、BandID が BAND_MANAGEMENT_CAPABILITIES の MaxBandCount メンバーより小さい場合、バンド一致の唯一の選択基準として BandID が使用されます。 BandID == –1 の場合、バンドを選択するための一致条件として BandStart と BandSize が使用されます。

BandStart と BandSize を使用してバンドを照合する場合、BandSize の正確なサイズを持つ BandStart の場所または後に構成された最初のバンドが返されます。 BandSize == 0 の場合、BandStart が有効な場合は、BandStart 以降に構成された最初のバンドが返されます。

BandID == 0 またはバンドが構成されておらず、Flags が ENUMBANDS_ENUM_ALL_BANDS に設定されていない場合は、デバイス全体のグローバルバンドが返されます。

BandStart と BandSize の値 (バイト単位) が、基になるストレージデバイスのセクターサイズの正確な倍数でない限り、有効ではありません。