IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
使用 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 请求检索与带关联的元数据。 带的元数据充当密钥管理器应用程序的数据区域。
主要代码
输入缓冲区
Irp-AssociatedIrp.SystemBuffer> 中的输入缓冲区必须包含GET_BAND_METADATA_PARAMETERS结构。
输入缓冲区长度
Parameters.DeviceIoControl.InputBufferLength 指示缓冲区的大小（以字节为单位），该 缓冲区 的大小必须至少为 (GET_BAND_METADATA_PARAMETERS) 。
输出缓冲区
Irp-AssociatedIrp.SystemBuffer> 中的输出缓冲区包含GET_BAND_METADATA_PARAMETERS指定的带元数据字节数组。
输出缓冲区长度
GET_BAND_METADATA_PARAMETERS结构的长度。
状态块
“信息”字段包含输出缓冲区中返回的字节数。 可以在 “状态” 字段中返回以下值之一。
| 状态值 | 说明 |
|---|---|
| STATUS_SUCCESS | 元数据在系统缓冲区中返回。 |
| STATUS_INVALID_DEVICE_REQUEST | 存储设备不支持带管理。 |
| STATUS_INVALID_BUFFER_SIZE | 输出缓冲区大小不正确。 |
| STATUS_INVALID_PARAMETER | 输入缓冲区中的信息无效。 |
| STATUS_NOT_FOUND | 找不到提供的选择条件的带。 |
| STATUS_IO_DEVICE_ERROR | 通信失败。 存储设备可能与安全协议不兼容。 |
注解
不需要对此 IOCTL 进行身份验证，并且身份验证密钥未作为输入包含在内。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从Windows 8开始可用 |
| 标头 | ehstorbandmgmt.h (包括 EhStorBandMgmt.h) |