IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)

  • Articolo

Un driver può emettere un codice di controllo IOCTL_STORAGE_REINITIALIZE_MEDIA per scaricare il processo di cancellazione nel dispositivo di archiviazione.

Codice principale

IRP_MJ_DEVICE_CONTROL

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

Vedi anche

IO_STATUS_BLOCK struttura

STORAGE_REINITIALIZE_MEDIA

Come completare un'IRP in una routine di invio