IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)
Драйвер может выпустить IOCTL_STORAGE_REINITIALIZE_MEDIA управляющий код для разгрузки процесса удаления на запоминающее устройство.
Основной код
Входной буфер
Для Windows Server 2022 и более поздних версий содержит необязательную структуру STORAGE_REINITIALIZE_MEDIA с параметрами очистки или null. В более ранних версиях ОС входной буфер имеет значение NULL.
Длина входного буфера
Для Windows 10 выпуска 21H1 и более поздних версий Parameters.DeviceIoControl.InputBufferLength указывает размер буфера параметров в байтах в Irp-AssociatedIrp.SystemBuffer>, который должен иметь значение >= sizeof(STORAGE_REINITIALIZE_MEDIA), если Parameters.DeviceIoControl.InputBuffer != NULL; в противном случае нуль. Для более ранних версий ОС длина входного буфера равна нулю.
Выходной буфер
Нет.
Длина выходного буфера
Нет.
Буфер входных и выходных данных
Недоступно
Длина входного/выходного буфера
Недоступно
Блок состояния
Если вызов завершится успешно, поле Information задается равным нулю; В противном случае ему присваивается ненулевое значение.
Комментарии
IOCTL_STORAGE_REINITIALIZE_MEDIA разгружает стирание на запоминающее устройство. После выполнения команды не гарантируется успешное удаление или восстановление данных запоминающего устройства.
Этот IOCTL ограничен дисками данных на устройствах в семействе настольных устройств. В среде предустановки Windows (WinPE) этот IOCTL поддерживается как для загрузочных дисков, так и для дисков данных.
В более ранних версиях ОС реализация не требует входных данных и не возвращает выходные данные, кроме состояния.
Вызывающие абоненты должны сначала вызвать FSCTL_LOCK_VOLUME перед вызовом этого IOCTL для очистки кэшированных данных в верхних слоях. Ожидание завершения незавершенного запроса не выполняется перед выполнением команды на устройстве.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10, версия 1607 |
| Минимальная версия сервера | Windows Server 2016 |
| Верхняя часть | ntddstor.h |