Condividi tramite


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

IRP_MJ_DEVICE_CONTROL

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

Vedere anche

IO_STATUS_BLOCK struttura

STORAGE_REINITIALIZE_MEDIA

Come completare un IRP in una routine dispatch