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或之后匹配一个乐队。
MetadataOffset
要从中检索数据的带元数据属性开头的偏移量。
MetadataSize
要检索的元数据字节的长度。
言论
优先于 BandID 进行带选择。 如果 BandID 大于 0,并且 BandID 小于 BAND_MANAGEMENT_CAPABILITIES的 MaxBandCount 成员,则 BandID 用作带匹配的唯一选择条件。 如果 BandID == –1,则 BandStart 用作选择带的匹配条件。 如果没有与任一选择条件匹配的带,则STATUS_INVALID_PARAMETER在 IoStatus 块中返回 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA。
如果 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) |