IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

Метаданные, связанные с полосой, извлекаются с помощью запроса IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA . Метаданные для диапазона служат областью данных для приложения диспетчера ключей.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Входной буфер в 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)

См. также раздел

BAND_LOCATION_INFO

BAND_SECURITY_INFO

CREATE_BAND_PARAMETERS