Funzione FsRtlNotifyVolumeEvent (ntifs.h)

  • Articolo

La routine FsRtlNotifyVolumeEvent notifica a tutte le applicazioni registrate che si verifica un evento del volume.

Sintassi

NTSTATUS FsRtlNotifyVolumeEvent(
  [in] PFILE_OBJECT FileObject,
  [in] ULONG        EventCode
);

Parametri

[in] FileObject

Puntatore a un oggetto file per il volume specificato.

[in] EventCode

Specifica un codice evento per l'evento che si verifica. Questo codice può essere uno dei valori seguenti.

Codice evento GUID dell'evento PnP Significato
FSRTL_VOLUME_BACKGROUND_FORMAT GUID_IO_VOLUME_BACKGROUND_FORMAT È stata avviata un'operazione di formato in background.
FSRTL_VOLUME_CHANGE_SIZE GUID_IO_VOLUME_CHANGE_SIZE Le dimensioni del file system nel volume sono state modificate. Per Windows Server 2003 e Windows XP/2000, questo valore non è supportato.
FSRTL_VOLUME_DISMOUNT GUID_IO_VOLUME_DISMOUNT Il volume viene smontato.
FSRTL_VOLUME_DISMOUNT_FAILED GUID_IO_VOLUME_DISMOUNT_FAILED Smontaggio del volume non riuscito.
FSRTL_VOLUME_FORCED_CLOSED GUID_IO_VOLUME_FORCE_CLOSED Il volume è stato reso di sola lettura dal file system. Questo flag è disponibile in Windows Vista e versioni successive.
FSRTL_VOLUME_INFO_MAKE_COMPAT GUID_IO_VOLUME_INFO_MAKE_COMPAT Il supporto del volume è stato rimosso, ma si trova in uno stato incompatibile e potrebbe non essere leggibile da un altro dispositivo di archiviazione multimediale rimovibile. Questo flag è disponibile in Windows Vista e versioni successive.
FSRTL_VOLUME_LOCK GUID_IO_VOLUME_LOCK Il volume è bloccato.
FSRTL_VOLUME_LOCK_FAILED GUID_IO_VOLUME_LOCK_FAILED Blocco del volume non riuscito.
FSRTL_VOLUME_MOUNT GUID_IO_VOLUME_MOUNT Il volume viene montato.
FSRTL_VOLUME_NEEDS_CHKDSK GUID_IO_VOLUME_NEED_CHKDSK Il danneggiamento dei dati è stato rilevato nel volume e deve essere corretto eseguendo Chkdsk. Questo flag è disponibile in Windows Vista e versioni successive.
FSRTL_VOLUME_PREPARING_EJECT GUID_IO_VOLUME_PREPARING_EJECT Il file system sta preparando il disco da espellere. Per Windows Server 2003 e Windows XP/2000, questo valore non è supportato.
FSRTL_VOLUME_UNLOCK GUID_IO_VOLUME_UNLOCK Il volume viene sbloccato.
FSRTL_VOLUME_WEARING_OUT GUID_IO_VOLUME_WEARING_OUT Il supporto del volume si sta consumando. Questo flag è disponibile in Windows Vista e versioni successive.
FSRTL_VOLUME_WORM_NEAR_FULL GUID_IO_VOLUME_WORM_NEAR_FULL Il volume è un volume write-once, read-many (WORM) ed è quasi pieno. Questo flag è disponibile in Windows Vista e versioni successive.

Valore restituito

FsRtlNotifyVolumeEvent restituisce lo stato della notifica.

Commenti

I file system chiamano FsRtlNotifyVolumeEvent per notificare a tutte le applicazioni registrate in modalità utente che si verifica un evento del volume.

I valori GUID dell'evento PnP sono definiti in Ioevent.h.

Per eseguire la registrazione per la notifica degli eventi del volume, le applicazioni devono chiamare la funzione Microsoft Win32 RegisterDeviceNotification . Per altre informazioni, vedere la sezione Gestione dispositivi nella documentazione di Microsoft Windows SDK.

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Vedi anche

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotification