Funzione FsRtlNotifyVolumeEvent (ntifs.h)
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 sta verificando. 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 dispositivo di archiviazione rimovibile diverso. 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 | Il 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 indossando. 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.
Osservazioni
I file system chiamano FsRtlNotifyVolumeEvent per notificare a tutte le applicazioni in modalità utente registrate 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 di volume, le applicazioni devono chiamare la funzione RegisterDeviceNotification di Microsoft Win32
Fabbisogno
| 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 |