FsRtlNotifyVolumeEvent, fonction (ntifs.h)
La routine FsRtlNotifyVolumeEvent avertit les applications inscrites qu’un événement de volume se produit.
Syntaxe
NTSTATUS FsRtlNotifyVolumeEvent(
[in] PFILE_OBJECT FileObject,
[in] ULONG EventCode
);
Paramètres
[in] FileObject
Pointeur vers un objet de fichier pour le volume donné.
[in] EventCode
Spécifie un code d’événement pour l’événement qui se produit. Ce code peut être l’une des valeurs suivantes.
| Code d’événement | GUID d’événement PnP | Signification |
|---|---|---|
| FSRTL_VOLUME_BACKGROUND_FORMAT | GUID_IO_VOLUME_BACKGROUND_FORMAT | Une opération de format en arrière-plan a été lancée. |
| FSRTL_VOLUME_CHANGE_SIZE | GUID_IO_VOLUME_CHANGE_SIZE | La taille du système de fichiers sur le volume a changé. Pour Windows Server 2003 et Windows XP/2000, cette valeur n’est pas prise en charge. |
| FSRTL_VOLUME_DISMOUNT | GUID_IO_VOLUME_DISMOUNT | Le volume est démonté. |
| FSRTL_VOLUME_DISMOUNT_FAILED | GUID_IO_VOLUME_DISMOUNT_FAILED | Échec du démontage du volume. |
| FSRTL_VOLUME_FORCED_CLOSED | GUID_IO_VOLUME_FORCE_CLOSED | Le volume a été effectué en lecture seule par le système de fichiers. Cet indicateur est disponible sur Windows Vista et versions ultérieures. |
| FSRTL_VOLUME_INFO_MAKE_COMPAT | GUID_IO_VOLUME_INFO_MAKE_COMPAT | Le support de volume a été supprimé, mais il est dans un état incompatible et peut ne pas être lisible par un autre périphérique de stockage amovible multimédia. Cet indicateur est disponible sur Windows Vista et versions ultérieures. |
| FSRTL_VOLUME_LOCK | GUID_IO_VOLUME_LOCK | Le volume est verrouillé. |
| FSRTL_VOLUME_LOCK_FAILED | GUID_IO_VOLUME_LOCK_FAILED | Échec du verrou de volume. |
| FSRTL_VOLUME_MOUNT | GUID_IO_VOLUME_MOUNT | Le volume est monté. |
| FSRTL_VOLUME_NEEDS_CHKDSK | GUID_IO_VOLUME_NEED_CHKDSK | L’altération des données a été détectée sur le volume et doit être corrigée en exécutant Chkdsk. Cet indicateur est disponible sur Windows Vista et versions ultérieures. |
| FSRTL_VOLUME_PREPARING_EJECT | GUID_IO_VOLUME_PREPARING_EJECT | Le système de fichiers prépare le disque à éjecter. Pour Windows Server 2003 et Windows XP/2000, cette valeur n’est pas prise en charge. |
| FSRTL_VOLUME_UNLOCK | GUID_IO_VOLUME_UNLOCK | Le volume est déverrouillé. |
| FSRTL_VOLUME_WEARING_OUT | GUID_IO_VOLUME_WEARING_OUT | Le média de volume est en cours d’usure. Cet indicateur est disponible sur Windows Vista et versions ultérieures. |
| FSRTL_VOLUME_WORM_NEAR_FULL | GUID_IO_VOLUME_WORM_NEAR_FULL | Le volume est un volume en écriture seule et en lecture-plusieurs (WORM) et il est presque plein. Cet indicateur est disponible sur Windows Vista et versions ultérieures. |
Valeur de retour
FsRtlNotifyVolumeEvent retourne l’état de la notification.
Remarques
Les systèmes de fichiers appellent FsRtlNotifyVolumeEvent pour notifier les applications en mode utilisateur inscrites qu’un événement de volume se produit.
Les valeurs GUID d’événement PnP sont définies dans Ioevent.h.
Pour vous inscrire à la notification d’événement en volume, les applications doivent appeler la fonction Microsoft Win32 RegisterDeviceNotification. Pour plus d’informations, consultez la section Gestion des appareils dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |