IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

Запрос IOCTL_EHSTOR_BANDMGMT_ERASE_BAND криптографически стирает и сбрасывает ключ проверки подлинности полосы. Оставшаяся конфигурация полосы остается без изменений.

Основной код

IRP_MJ_DEVICE_CONTROL

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

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

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

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

Parameters.DeviceIoControl.InputBufferLength указывает размер буфера в байтах, который должен быть не менее sizeof(ERASE_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	Сбой связи. Устройство хранения может быть несовместимо с протоколами безопасности.

Комментарии

Текущий ключ проверки подлинности очистки не указан в запросе IOCTL_EHSTOR_BANDMGMT_ERASE_BAND . Ключ проверки подлинности очистки для запоминаемого устройства настроен ранее.

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

Когда полоса стирается с помощью IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, единственными предыдущими свойствами, которые остаются, являются начало и размер полосы. Предыдущий ключ шифрования мультимедиа удаляется и создается новый ключ. Параметр Locking имеет значение PERSISTANT_UNLOCK как для чтения, так и для записи. Ранее заданные метаданные безопасности удаляются. Новый ключ проверки подлинности, указанный в ERASE_BAND_PARAMETERS , задается, если не указано использование ключа по умолчанию.

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

Изменения, внесенные в таблицу диапазонов этим запросом, фиксируются на устройстве атомарно до завершения запроса IOCTL. Таким образом, гарантируется, что полоса будет изменена со всеми заданными свойствами или вообще не будет задана, если произойдет сбой системы или питания.

Требования

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

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

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS