Compartir a través de

IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)

  • Artículo

Un controlador puede emitir un código de control IOCTL_STORAGE_REINITIALIZE_MEDIA para descargar el proceso de borrado en el dispositivo de almacenamiento.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Para Windows Server 2022 y versiones posteriores, contiene una estructura de STORAGE_REINITIALIZE_MEDIA opcional con opciones de saneamiento o NULL. Para versiones anteriores del sistema operativo, el búfer de entrada es NULL.

Longitud del búfer de entrada

Para Windows 10 versión 21H1 y posteriores, Parameters.DeviceIoControl.InputBufferLength indica el tamaño, en bytes, del búfer de parámetros en Irp-AssociatedIrp.SystemBuffer>, que debe ser >= sizeof(STORAGE_REINITIALIZE_MEDIA) si Parameters.DeviceIoControl.InputBuffer != NULL; en caso contrario, cero. En las versiones anteriores del sistema operativo, la longitud del búfer de entrada es cero.

Búfer de salida

Ninguno.

Longitud del búfer de salida

Ninguno.

Búfer de entrada y salida

N/D

Longitud del búfer de entrada y salida

N/D

Bloque de estado

El campo Información se establece en cero si la llamada se completa correctamente; de lo contrario, se establece en un valor distinto de cero.

Comentarios

IOCTL_STORAGE_REINITIALIZE_MEDIA descarga la eliminación en el dispositivo de almacenamiento. No hay ninguna garantía en cuanto a la eliminación correcta o la capacidad de recuperación de los datos del dispositivo de almacenamiento una vez completado el comando.

Este IOCTL se limita a los discos de datos de los dispositivos de la familia de dispositivos de escritorio. En el entorno de preinstalación de Windows (WinPE), este IOCTL es compatible con discos de datos y de arranque.

En versiones anteriores del sistema operativo, la implementación no requiere ninguna entrada y no devuelve ninguna salida distinta del estado.

Los autores de llamadas deben llamar primero a FSCTL_LOCK_VOLUME antes de llamar a este IOCTL para vaciar los datos almacenados en caché en las capas superiores. No se realiza ninguna espera de finalización de la solicitud pendiente antes de emitir el comando al dispositivo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1607
Servidor mínimo compatible Windows Server 2016
Encabezado ntddstor.h

Consulte también

estructura de IO_STATUS_BLOCK

STORAGE_REINITIALIZE_MEDIA

Cómo completar un IRP en una rutina de envío