IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)
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
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 |