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; в противном случае ноль. Для более ранних версий ОС длина входного буфера равна нулю.
Выходной буфер
Никакой.
Длина выходного буфера
Никакой.
Буфер входных и выходных данных
n/a
Длина буфера ввода и вывода
n/a
Блок состояния
Поле сведений равно нулю, если вызов завершается успешно; в противном случае оно имеет значение, отличное от нуля.
Замечания
IOCTL_STORAGE_REINITIALIZE_MEDIA выгрузит на устройство хранилища стирание. После завершения команды не гарантируется успешное удаление или восстановление данных устройства хранения.
Этот IOCTL ограничен дисками данных на устройствах в семействе классических устройств. В среде предварительной установки Windows (WinPE) этот IOCTL поддерживается как для дисков загрузки, так и для дисков данных.
В более ранних версиях ОС реализация не требует входных данных и не возвращает выходные данные, отличные от состояния.
Вызывающие абоненты должны сначала вызывать FSCTL_LOCK_VOLUME перед вызовом этого IOCTL для очистки кэшированных данных в верхних слоях. Ожидание завершения незавершенного запроса не выполняется до выдачи команды на устройство.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 версии 1607 |
| минимальный поддерживаемый сервер | Windows Server 2016 |
| заголовка | ntddstor.h |