GET_BAND_METADATA_PARAMETERS構造体 (ehstorbandmgmt.h)

  • [アーティクル]

構成されたバンドのメタデータは、 GET_BAND_METADATA_PARAMETERS 構造体のパラメーターに従って取得されます。 この構造体は、 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 要求に対する入力です。

構文

typedef struct _GET_BAND_METADATA_PARAMETERS {
  ULONG         StructSize;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         MetadataOffset;
  ULONG         MetadataSize;
} GET_BAND_METADATA_PARAMETERS, *PGET_BAND_METADATA_PARAMETERS;

メンバー

StructSize

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

BandId

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

BandStart

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

MetadataOffset

データを取得するバンド メタデータ プロパティの先頭からのオフセット。

MetadataSize

取得するメタデータ バイトの長さ。

注釈

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

BandID と BandStart の両方が –1 に設定されている場合、IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATAはグローバル バンドのメタデータを返します。

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA成功した場合、Parameters.DeviceIoControl.InputBufferLength は MetadataSize の値と等しくなります。

要件

要件 値
サポートされている最小のクライアント Windows 8 以降で使用可能
Header ehstorbandmgmt.h (EhStorBandMgmt.h を含む)

こちらもご覧ください

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA