IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

Статья
02/06/2025

Метаданные, связанные с полосой, извлекаются с помощью запроса 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 структуры.

Блок состояния

Поле сведений содержит количество байтов, возвращаемых в выходном буфере. Одно из следующих значений можно вернуть в поле Status.

Значение состояния	Описание
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 (include EhStorBandMgmt.h)