Fonction FsRtlNotifyFullChangeDirectory (ntifs.h)
La routine FsRtlNotifyFullChangeDirectory crée une structure de notification pour une demande de notification et l’ajoute à la liste des notifications spécifiée.
Syntaxe
void FsRtlNotifyFullChangeDirectory(
[in] PNOTIFY_SYNC NotifySync,
[in] PLIST_ENTRY NotifyList,
[in] PVOID FsContext,
[in] PSTRING FullDirectoryName,
[in] BOOLEAN WatchTree,
[in] BOOLEAN IgnoreBuffer,
[in] ULONG CompletionFilter,
[in, optional] PIRP NotifyIrp,
[in, optional] PCHECK_FOR_TRAVERSE_ACCESS TraverseCallback,
[in, optional] PSECURITY_SUBJECT_CONTEXT SubjectContext
);
Paramètres
[in] NotifySync
Pointeur vers un objet de synchronisation opaque pour la liste de notifications du volume actuel.
[in] NotifyList
Pointeur vers le début d’une liste de notifications. Chaque élément de la liste est une structure de notification opaque.
[in] FsContext
Pointeur vers une valeur unique affectée par le système de fichiers pour identifier la structure de notification à créer comme appartenant à un objet de fichier particulier. Si une routine TraverseCallback est fournie, FsContext est passé en tant que paramètre NotifyContext à cette routine.
[in] FullDirectoryName
Pointeur vers une chaîne ANSI ou Unicode qui contient le nom complet du répertoire associé à cette structure de notification. Ignoré si NotifyIrp a la valeur NULL.
[in] WatchTree
Définissez sur TRUE si tous les sous-répertoires de ce répertoire doivent également être surveillés. Définissez sur FALSE si seul le répertoire lui-même doit être surveillé. Ignoré si NotifyIrp a la valeur NULL.
[in] IgnoreBuffer
Définissez sur TRUE pour ignorer les mémoires tampons utilisateur et forcer le répertoire à être réumé. Cette action accélère l’opération. Ignoré si NotifyIrp a la valeur NULL.
[in] CompletionFilter
Masque de bits d’indicateurs qui spécifient les types de modifications apportées aux fichiers ou sous-répertoires qui doivent entraîner la fin de la file d’attente des irps de notification en attente. Le tableau suivant décrit les valeurs d’indicateur possibles.
| Indicateur | Signification |
|---|---|
| FILE_NOTIFY_CHANGE_FILE_NAME (0x0001) | Un fichier a été ajouté, supprimé ou renommé dans ce répertoire. |
| FILE_NOTIFY_CHANGE_DIR_NAME (0x0002) | Un sous-répertoire a été créé, supprimé ou renommé. |
| FILE_NOTIFY_CHANGE_NAME (0x0003) | Le nom de ce répertoire a changé. |
| FILE_NOTIFY_CHANGE_ATTRIBUTES (0x0004) | La valeur d’un attribut de ce fichier, comme l’heure du dernier accès, a changé. |
| FILE_NOTIFY_CHANGE_SIZE (0x0008) | La taille de ce fichier a changé. |
| FILE_NOTIFY_CHANGE_LAST_WRITE (0x0010) | L’heure de la dernière modification de ce fichier a changé. |
| FILE_NOTIFY_CHANGE_LAST_ACCESS (0x0020) | L’heure du dernier accès de ce fichier a changé. |
| FILE_NOTIFY_CHANGE_CREATION (0x0040) | L’heure de création de ce fichier a changé. |
| FILE_NOTIFY_CHANGE_EA (0x0080) | Les attributs étendus de ce fichier ont été modifiés. |
| FILE_NOTIFY_CHANGE_SECURITY (0x0100) | Les informations de sécurité de ce fichier ont changé. |
| FILE_NOTIFY_CHANGE_STREAM_NAME (0x0200) | Un flux de fichiers a été ajouté, supprimé ou renommé dans ce répertoire. |
| FILE_NOTIFY_CHANGE_STREAM_SIZE (0x0400) | La taille de ce flux de fichiers a changé. |
| FILE_NOTIFY_CHANGE_STREAM_WRITE (0x0800) | Les données de ce flux de fichiers ont changé. |
CompletionFilter est ignoré si NotifyIrp a la valeur NULL.
[in, optional] NotifyIrp
Pointeur vers l’IRP pour effectuer une notification de modification. Si NotifyIrp a la valeur NULL, cela signifie que le flux de fichiers représenté par cet objet de fichier est en cours de suppression.
[in, optional] TraverseCallback
Pointeur facultatif vers une routine de rappel à appeler lorsqu’une modification se produit dans un sous-répertoire surveillé dans une arborescence de répertoires. Cela permet au système de fichiers case activée si l’observateur a accès à ce répertoire. Une telle routine fournie par l’appelant est déclarée comme suit :
NTSTATUS
(*PCHECK_FOR_TRAVERSE_ACCESS) (
IN PVOID NotifyContext, // FsContext
IN PVOID TargetContext, // Context pointer
IN PSECURITY_SUBJECT_CONTEXT SubjectContext // SubjectContext
);
Pour plus d’informations sur le paramètre TargetContext , consultez le paramètre TargetContext de FsRtlNotifyFullReportChange. TraverseCallback est ignoré si NotifyIrp a la valeur NULL.
[in, optional] SubjectContext
Un pointeur vers une structure SECURITY_SUBJECT_CONTEXT à passer à TraverseCallback. FsRtlNotifyFullChangeDirectory libère le contexte et libère la structure après l’avoir utilisé. Ignoré si NotifyIrp a la valeur NULL. Si une routine TraverseCallback est fournie, SubjectContext est passé en tant que paramètre SubjectContext à cette routine.
Valeur de retour
None
Remarques
FsRtlNotifyFullChangeDirectory est appelé par un système de fichiers qui a reçu une demande de modification de notification. Cette demande est reçue en tant qu’IRP avec le code de fonction principal IRP_MJ_DIRECTORY_CONTROL, le code de fonction secondaire IRP_MN_NOTIFY_CHANGE_DIRECTORY.
Si NotifyIrp a la valeur NULL, FsRtlNotifyFullChangeDirectory vérifie si la liste des notifications contient un IRP en attente qui fait référence à cet objet de fichier et, si c’est le cas, la complète avec STATUS_DELETE_PENDING.
Si NotifyIrp n’a pas la valeur NULL, FsRtlNotifyFullChangeDirectory effectue les opérations suivantes :
Vérifie si l’objet fichier a subi un nettoyage. Si c’est le cas, FsRtlNotifyFullChangeDirectory effectue l’IRP de notification avec status STATUS_NOTIFY_CLEANUP.
Si l’objet fichier n’a pas subi de nettoyage, FsRtlNotifyFullChangeDirectory vérifie si la liste des notifications pour ce volume contient déjà une structure de notification pour cette modification. Si c’est le cas, FsRtlNotifyFullChangeDirectory effectue tous les irps en attente. Si ce n’est pas le cas, FsRtlNotifyFullChangeDirectory marque l’IRP de notification comme étant en attente, crée une structure de notification et l’insère dans la liste.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ntifs.h (inclure Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm) |