Fonction FsRtlNotifyVolumeEvent (ntifs.h)
La routine FsRtlNotifyVolumeEvent avertit toutes 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 mise en forme 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 en cours de 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é créé 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 multimédia amovible. 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 verrouillage du volume. |
| FSRTL_VOLUME_MOUNT | GUID_IO_VOLUME_MOUNT | Le volume est en cours de montage. |
| FSRTL_VOLUME_NEEDS_CHKDSK | GUID_IO_VOLUME_NEED_CHKDSK | Une 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 à être éjecté. 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 en cours de déverrouillage. |
| FSRTL_VOLUME_WEARING_OUT | GUID_IO_VOLUME_WEARING_OUT | Le média de volume s’est usé. 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 lecture multiple (WORM) en écriture unique et il est presque plein. Cet indicateur est disponible sur Windows Vista et versions ultérieures. |
Valeur retournée
FsRtlNotifyVolumeEvent retourne le status de la notification.
Remarques
Les systèmes de fichiers appellent FsRtlNotifyVolumeEvent pour informer toutes 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 s’inscrire à la notification d’événement de volume, les applications doivent appeler la fonction Microsoft Win32 RegisterDeviceNotification . Pour plus d’informations, consultez la section Gestion des appareils dans la documentation Microsoft Windows SDK.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP |
| Plateforme cible | Universal |
| En-tête | ntifs.h (inclure Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |