IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)
Запрос IOCTL_EHSTOR_BANDMGMT_ERASE_BAND криптографически стирает и сбрасывает ключ проверки подлинности полосы. Оставшаяся конфигурация полосы остается без изменений.
Основной код
Входной буфер
Входной буфер в 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) |