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 l'handle usato per smontarlo, 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 in un volume offline, ma le operazioni di I/O indirizzate a un volume offline hanno esito negativo. L'uso 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

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 dello stato

Il membro Status è impostato su STATUS_SUCCESS.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows XP.
Intestazione	ntddvol.h (include Ntddvol.h)

Vedi anche

IOCTL_VOLUME_ONLINE