IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)
Un driver può emettere un codice di controllo IOCTL_STORAGE_REINITIALIZE_MEDIA per scaricare il processo di cancellazione nel dispositivo di archiviazione.
Codice principale
Buffer di input
Per Windows Server 2022 e versioni successive, contiene una struttura facoltativa STORAGE_REINITIALIZE_MEDIA con opzioni di sanificazione o NULL. Per le versioni precedenti del sistema operativo, il buffer di input è NULL.
Lunghezza del buffer di input
Per Windows 10 versione 21H1 e versioni successive, Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer dei parametri in Irp-AssociatedIrp.SystemBuffer>, che deve essere >= sizeof(STORAGE_REINITIALIZE_MEDIA) se Parameters.DeviceIoControl.InputBuffer != NULL; in caso contrario zero. Per le versioni precedenti del sistema operativo, la lunghezza del buffer di input è zero.
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Input/Buffer di output
n/d
Lunghezza del buffer di input/output
n/d
Blocco dello stato
Il campo Informazioni è impostato su zero se la chiamata viene completata correttamente; in caso contrario, è impostato su un valore diverso da zero.
Commenti
IOCTL_STORAGE_REINITIALIZE_MEDIA scarica la cancellazione nel dispositivo di archiviazione. Non vi è alcuna garanzia per l'eliminazione riuscita o la ripristinabilità dei dati del dispositivo di archiviazione dopo il completamento del comando.
Questo IOCTL è limitato ai dischi dati nei dispositivi nella famiglia di dispositivi desktop. In Windows Preinstallation Environment (WinPE), questo IOCTL è supportato sia per i dischi di avvio che per i dischi dati.
Nelle versioni precedenti del sistema operativo l'implementazione non richiede alcun input e non restituisce alcun output diverso dallo stato.
I chiamanti devono prima chiamare FSCTL_LOCK_VOLUME prima di chiamare questo IOCTL per scaricare i dati memorizzati nella cache in livelli superiori. Non viene eseguita alcuna attesa del completamento della richiesta in sospeso prima di emettere il comando al dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 versione 1607 |
| Server minimo supportato | Windows Server 2016 |
| Intestazione | ntddstor.h |