Share via

IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)

  • Статья

Драйвер может выпустить IOCTL_STORAGE_REINITIALIZE_MEDIA управляющий код для разгрузки процесса удаления на запоминающее устройство.

Основной код

IRP_MJ_DEVICE_CONTROL

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

Для 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

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

структура IO_STATUS_BLOCK

STORAGE_REINITIALIZE_MEDIA

Как завершить IRP в подпрограмме диспетчеризации