通过

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

要返回其信息的单个波段的标识符。 使用 BandId 选择单个波段时，BandSize 必须为 0。若要使用 BandStart 和 BandSize 而不是 BandId 选择波段，请将 BandId = (ULONG) –1。

BandStart

用于开始带搜索的存储设备上的起始字节位置。 尝试在 BandStart 或 BandStart 之后匹配一个乐队。

MetadataOffset

从要从中检索数据的 band 元数据属性开头的偏移量。

MetadataSize

要检索的元数据字节的长度。

注解

优先于 BandID 进行波段选择。 如果 BandID 大于 0 且 BandID 小于 BAND_MANAGEMENT_CAPABILITIES 的 MaxBandCount 成员，则 BandID 用作带匹配的唯一选择条件。 如果 BandID == –1，则将 BandStart 用作选择波段的匹配条件。 如果没有波段与任一选择条件匹配，则会在 IoStatus 块中返回 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA STATUS_INVALID_PARAMETER。

如果 BandID 和 BandStart 都设置为 –1，则 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 返回全局波段的元数据。

如果 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 成功， 则 Parameters.DeviceIoControl.InputBufferLength 等于 MetadataSize 中的值。

要求

要求 值
最低受支持的客户端 从Windows 8开始可用
标头 ehstorbandmgmt.h (包括 EhStorBandMgmt.h)

另请参阅

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA