IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

Cancella tutte le informazioni sullo snapshot basato su hardware del servizio Copia Shadow del volume dal disco. Uno snapshot è noto anche come copia shadow. Questa richiesta è disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. Il chiamante deve essere in esecuzione in IRQL = PASSIVE_LEVEL.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

Nessuno.

Lunghezza del buffer di output

Nessuno.

Blocco di stato

Il membro Informazioni è impostato su zero. Il membro Stato è impostato su STATUS_SUCCESS se l'operazione ha avuto esito positivo. In caso contrario, il membro Status è impostato sul codice di errore appropriato.

Osservazioni

Questo codice di controllo di I/O può essere emesso da un driver in modalità kernel o da un'applicazione in modalità utente. Quando questo codice di controllo di I/O viene emesso da un driver in modalità kernel, il chiamante fornisce un pacchetto di richiesta I/O (IRP) che contiene una struttura di dati IO_STATUS_BLOCK. Questa struttura di dati viene utilizzata per restituire informazioni sull'errore al chiamante. Quando questo codice di controllo I/O viene emesso da un'applicazione in modalità utente con la routine DeviceIocontrol, il chiamante può ottenere informazioni sull'errore chiamando la routine GetLastError.

Il disco il cui handle viene usato quando viene emesso questo IOCTL potrebbe trovarsi nello stato offline quando viene emesso IOCTL. Se lo stato del disco è offline tramite lo snap-in Gestione dischi di Microsoft Management Console (MMC), il disco avrà il relativo attributo di sola lettura impostato, che causerà l'esito negativo di questo IOCTL. Tuttavia, se l'utilità di partizione del disco (Diskpart.exe) viene usata per inserire il disco nello stato offline, l'attributo di sola lettura per il disco non è impostato. Per questo motivo, è consigliabile usare l'utilità di partizione del disco per inserire un disco nello stato offline.

Si noti Un effetto collaterale dell'uso di questo IOCTL è che gli strumenti di gestione disco possono segnalare una partizione aggiuntiva del tipo "UNKNOWN" nei dischi GPT. Questa partizione da 256 kilobyte viene creata dall'operazione IOCTL ed è una partizione snapshot usata nel processo di ripristino. Questa partizione è prevista e può essere ignorata dagli amministratori di sistema.

 

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows Vista.
intestazione	ntdddisk.h (include Ntdddisk.h)
IRQL	PASSIVE_LEVEL