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 .
Блок состояния
Поле Information содержит количество байтов, возвращаемых в выходном буфере. В поле Состояние можно вернуть одно из следующих значений.
| Значение состояния | Описание |
|---|---|
| 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) |