IOCTL_VOLUME_OFFLINE IOCTL (ntddvol.h)
Il IOCTL_VOLUME_OFFLINE IOCTL inserisce il volume in uno stato OFFLINE, ovvero uno stato in cui le operazioni di lettura e scrittura avranno esito negativo. Le richieste non verranno passate al disco fisico finché non viene ricevuta una IOCTL_VOLUME_ONLINE successiva.
Un uso comune per IOCTL_VOLUME_OFFLINE è un caso in cui un'applicazione o un driver vuole impedire che un volume venga rimontato da una chiamata per aprire il volume da una seconda applicazione o driver mentre il volume è in corso di rimozione dal primo applicazione o driver. Ad esempio, prima di mascherare un numero di unità logica (LUN), i volumi nel LUN devono essere bloccati (facoltativi), smontati, portati offline e disinstallati. Ora il LUN può essere mascherato senza causare la registrazione degli eventi di rimozione delle sorprese plug and play (PnP) per i volumi e il disco stesso. Senza la chiamata per portare offline il volume, dopo che l'handle usato per smontarlo viene chiuso, il volume può quindi essere rimontato da una chiamata per aprirlo da un'altra applicazione o driver, se si è verificato prima della chiamata per disinstallare il volume. Una chiamata per aprire un volume ha esito positivo su un volume offline, ma l'I/O diretto verso un volume offline ha esito negativo. L'esecuzione offline di un volume non ha alcun effetto sull'I/O del disco (se l'applicazione o il driver ha aperto un handle sul disco), ma arresta l'I/O del volume (se l'applicazione o il driver ha aperto un handle al volume).
Codice principale
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 status è impostato su STATUS_SUCCESS.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows XP. |
| intestazione | ntddvol.h (include Ntddvol.h) |