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。 若要使用 BandStartBandSize 而不是 BandId 来选择带,请将 BandId = (ULONG) –1。

BandStart

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

MetadataOffset

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

MetadataSize

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

言论

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

如果 BandIDBandStart 都设置为 –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