IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)
Un driver può emettere un codice di controllo IOCTL_STORAGE_REINITIALIZE_MEDIA per eseguire l'offload del processo di cancellazione nel dispositivo di archiviazione.
Codice principale
Buffer di input
Per Windows Server 2022 e versioni successive, contiene una struttura di STORAGE_REINITIALIZE_MEDIA facoltativa con opzioni di purificazione 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 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.
Buffer di input/output
n/a
Lunghezza del buffer di input/output
n/a
Blocco di stato
Il campo informazioni è impostato su zero se la chiamata viene completata correttamente; in caso contrario, è impostato su un valore diverso da zero.
Osservazioni
IOCTL_STORAGE_REINITIALIZE_MEDIA scarica la cancellazione nel dispositivo di archiviazione. Non vi è alcuna garanzia per quanto riguarda l'eliminazione o la recuperabilità dei dati del dispositivo di archiviazione al termine del comando.
Questo IOCTL è limitato ai dischi dati nei dispositivi della 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 nei livelli superiori. Non viene eseguita alcuna attesa di completamento della richiesta in sospeso prima di eseguire il comando al dispositivo.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Windows 10, versione 1607 |
server minimo supportato | Windows Server 2016 |
intestazione | ntddstor.h |