IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)

Статья
08/07/2023

Настроенный диапазон на запоминающее устройство удаляется с помощью запроса IOCTL_EHSTOR_BANDMGMT_DELETE_BAND . Параметр очистки во входных параметрах позволяет запросу выполнять криптографическое стирание данных диапазона.

Основной код

IRP_MJ_DEVICE_CONTROL

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

Входной буфер в Irp-AssociatedIrp.SystemBuffer> должен содержать DELETE_BAND_PARAMETERS и, возможно, структуру AUTH_KEY.

Если для элемента AuthKeyOffsetDELETE_BAND_PARAMETERS задано значение EHSTOR_BANDMGR_NO_KEY, входные данные в системном буфере не должны содержать структуру AUTH_KEY .

Длина входного буфера

Parameters.DeviceIoControl.InputBufferLength указывает размер буфера в байтах, который должен быть не менее sizeof (DELETE_BAND_PARAMETERS) + sizeof(AUTH_KEY).

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

Нет.

Длина выходного буфера

Нет.

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

В поле Состояние можно вернуть одно из следующих значений.

Значение состояния	Описание
STATUS_SUCCESS	Группа была успешно удалена.
STATUS_INVALID_DEVICE_REQUEST	Запоминающее устройство не поддерживает управление полосами.
STATUS_INVALID_BUFFER_SIZE	Неправильный размер входного буфера.
STATUS_INVALID_PARAMETER	Недопустимые сведения во входном буфере.
STATUS_ACCESS_DENIED	Недопустимый ключ проверки подлинности или полоса заблокирована для записи.
STATUS_NOT_FOUND	Группа не найдена по указанным критериям отбора.
STATUS_IO_DEVICE_ERROR	Сбой связи. Устройство хранения может быть несовместимо с протоколами безопасности.

Ключ проверки подлинности требуется для удаления полосы без предварительного стирания. Чтобы запросить стирание полосы, флаг DELBAND_ERASE_BEFORE_DELETE устанавливается в элементе FlagsDELETE_BAND_PARAMETERS.

После удаления полосы все подсистемы балансировки нагрузки, содержащиеся в удаленном диапазоне, возвращаются в глобальную группу. Условия блокировки для глобального диапазона теперь применяются к подсистемам балансировки нагрузки, возвращенным в глобальный диапазон. Теперь LBA, возвращенные в глобальный диапазон, связываются с ключом мультимедиа для глобального диапазона, и зашифрованные данные в этих контроллерах балансировки нагрузки невосстановляются.

Удаленная полоса остается в таблице полосы драйвера бункера, но становится ненастроенной. Ключ проверки подлинности сбрасывается до значения по умолчанию, а метаданные диапазона и ключа содержат нули, а состояния блокировки отменить изменения PERSISTENT_UNLOCK. Теперь диапазон доступен для перенастройки с помощью запроса IOCTL_EHSTOR_BANDMGMT_CREATE_BAND .

Удаление полосы без криптографического удаления не приведет к удалению ключа шифрования для этого диапазона. Позже можно создать полосу с той же конфигурацией и идентификатором полосы, что и у удаленного диапазона. В этом случае будут доступны данные, ранее хранящиеся в полосе и не перезаписанные после удаления предыдущего диапазона. Чтобы избежать этой ситуации, удалите группу с флагом DELBAND_ERASE_BEFORE_DELETE , установленным в DELETE_BAND_PARAMETERS.

Глобальный диапазон не удаляется IOCTL_EHSTOR_BANDMGMT_DELETE_BAND. Запрос на это вернет STATUS_INVALID_PARAMETER.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Верхняя часть	ehstorbandmgmt.h (включая EhStorBandMgmt.h)