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.

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

Voir aussi

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL

SECURITY_SUBJECT_CONTEXT