IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)

Запрос IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS криптографически стирает и сбрасывает ключи проверки подлинности для всех настроенных диапазонов.

Основной код

IRP_MJ_DEVICE_CONTROL

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

Нет.

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

Нет.

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

Нет.

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

Нет.

Буфер входных и выходных данных

Нет.

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

Нет.

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

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

Значение состояния	Описание
STATUS_SUCCESS	Все группы были успешно стерты.
STATUS_INVALID_DEVICE_REQUEST	Устройство хранения не поддерживает управление диапазоном.
STATUS_IO_DEVICE_ERROR	Сбой связи. Устройство хранения может быть несовместимо с протоколами безопасности.

Комментарии

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS криптографически стирает и сбрасывает ключ проверки подлинности для каждого настроенного диапазона на устройстве хранения по одному диапазону за раз. Если все настроенные полосы успешно удалены, IOCTL вернет состояние успешного выполнения. Если очистка завершается сбоем для одного или нескольких настроенных диапазонов, IOCTL вернет состояние сбоя из первого настроенного диапазона, для которого произошла ошибка. В этом случае клиент должен вернуться к вызову IOCTL_EHSTOR_BANDMGMT_ERASE_BAND для каждого настроенного диапазона.

Нет гарантии атомарности для стирание в нескольких настроенных диапазонах. Таким образом, если во время обработки IOCTL происходит сбой системы или питания, некоторые настроенные полосы могут быть успешно удалены, а другие — нет.

Требования

Требование	Значение
Минимальная версия клиента	Windows 11 версии 22H2
Верхняя часть	ehstorbandmgmt.h

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

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND