FsRtlNotifyFullChangeDirectory-Makro (rxprocs.h)

  • Artikel

Die FsRtlNotifyFullChangeDirectory-Routine erstellt eine Benachrichtigungsstruktur für eine Benachrichtigungsanforderung und fügt sie der angegebenen Benachrichtigungsliste hinzu.

Syntax

void FsRtlNotifyFullChangeDirectory(
   A1,
   A2,
   A3,
   A4,
   A5,
   A6,
   A7,
   A8,
   A9,
   A10
);

Parameter

A1

Ein Zeiger auf ein undurchsichtiges Synchronisierungsobjekt für die Benachrichtigungsliste für das aktuelle Volume.

A2

Ein Zeiger auf den Kopf einer Benachrichtigungsliste. Jedes Element in der Liste ist eine undurchsichtige Benachrichtigungsstruktur.

A3

Ein Zeiger auf einen eindeutigen Wert, der vom Dateisystem zugewiesen wird, um die zu erstellende Benachrichtigungsstruktur als zu einem bestimmten Dateiobjekt zu identifizieren. Wenn eine TraverseCallback-Routine angegeben wird, wird FsContext als NotifyContext-Parameter an diese Routine übergeben.

A4

Ein Zeiger auf eine ANSI- oder Unicode-Zeichenfolge, die den vollständigen Namen für das Verzeichnis enthält, das dieser Benachrichtigungsstruktur zugeordnet ist. Wird ignoriert, wenn NotifyIrpNULL ist.

A5

Legen Sie auf TRUE fest, wenn alle Unterverzeichnisse dieses Verzeichnisses ebenfalls überwacht werden sollen. Legen Sie auf FALSE fest, wenn nur das Verzeichnis selbst überwacht werden soll. Wird ignoriert, wenn NotifyIrpNULL ist.

A6

Legen Sie auf TRUE fest, um alle Benutzerpuffer zu ignorieren und zu erzwingen, dass das Verzeichnis erneut aufgezählt wird. Diese Aktion beschleunigt den Vorgang. Wird ignoriert, wenn NotifyIrpNULL ist.

A7

Bitmaske von Flags, die die Arten von Änderungen an Dateien oder Unterverzeichnissen angeben, die dazu führen sollen, dass die Warteschlange der ausstehenden Benachrichtigungs-IRPs abgeschlossen wird. Die möglichen Flagwerte werden im Folgenden beschrieben.

Flag Bedeutung

FILE_NOTIFY_CHANGE_FILE_NAME

In diesem Verzeichnis wurde eine Datei hinzugefügt, gelöscht oder umbenannt.

FILE_NOTIFY_CHANGE_DIR_NAME

Ein Unterverzeichnis wurde erstellt, entfernt oder umbenannt.

FILE_NOTIFY_CHANGE_NAME

Der Name dieses Verzeichnisses wurde geändert.

FILE_NOTIFY_CHANGE_ATTRIBUTES

Der Wert eines Attributs dieser Datei, z. B. die Uhrzeit des letzten Zugriffs, wurde geändert.

FILE_NOTIFY_CHANGE_SIZE

Die Größe dieser Datei hat sich geändert.

FILE_NOTIFY_CHANGE_LAST_WRITE

Die Letzte Änderungszeit dieser Datei wurde geändert.

FILE_NOTIFY_CHANGE_LAST_ACCESS

Die Letzte Zugriffszeit dieser Datei wurde geändert.

FILE_NOTIFY_CHANGE_CREATION

Die Erstellungszeit dieser Datei hat sich geändert.

FILE_NOTIFY_CHANGE_EA

Die erweiterten Attribute dieser Datei wurden geändert.

FILE_NOTIFY_CHANGE_SECURITY

Die Sicherheitsinformationen dieser Datei wurden geändert.

FILE_NOTIFY_CHANGE_STREAM_NAME

In diesem Verzeichnis wurde ein Dateistream hinzugefügt, gelöscht oder umbenannt.

FILE_NOTIFY_CHANGE_STREAM_SIZE

Die Größe dieses Dateistreams wurde geändert.

FILE_NOTIFY_CHANGE_STREAM_WRITE

Die Daten dieses Dateistreams wurden geändert.

 

CompletionFilter wird ignoriert, wenn NotifyIrpNULL ist.

A8

Ein Zeiger auf den IRP, der bei der Änderung der Benachrichtigung abgeschlossen werden soll. Wenn NotifyIrpNULL ist, bedeutet dies, dass der von diesem Dateiobjekt dargestellte Dateistream gelöscht wird.

A9

Optionaler Zeiger auf eine Rückrufroutine, die aufgerufen werden soll, wenn eine Änderung in einem Unterverzeichnis auftritt, das in einer Verzeichnisstruktur überwacht wird. Dadurch kann das Dateisystem überprüfen, ob der Watcher Zugriff auf dieses Verzeichnis hat. Eine solche vom Aufrufer bereitgestellte Routine wird wie folgt deklariert:

NTSTATUS
(*PCHECK_FOR_TRAVERSE_ACCESS) (
    IN PVOID NotifyContext,                     // FsContext
    IN PVOID TargetContext,                     // Context pointer
    IN PSECURITY_SUBJECT_CONTEXT SubjectContext // SubjectContext
    );

Weitere Informationen zum TargetContext-Parameter finden Sie im TargetContext-Parameter von FsRtlNotifyFullReportChange. TraverseCallback wird ignoriert, wenn NotifyIrpNULL ist.

A10

Ein Zeiger auf eine Kontextstruktur, die an TraverseCallback übergeben werden soll. FsRtlNotifyFullChangeDirectory gibt den Kontext frei und gibt die Struktur nach der Verwendung frei. Wird ignoriert, wenn NotifyIrpNULL ist. Wenn eine TraverseCallback-Routine angegeben wird, wird SubjectContext als SubjectContext-Parameter an diese Routine übergeben.

Rückgabewert

Keine

Bemerkungen

FsRtlNotifyFullChangeDirectory wird von einem Dateisystem aufgerufen, das eine Benachrichtigungsänderungsanforderung erhalten hat. Diese Anforderung wird als IRP mit Hauptfunktionscode IRP_MJ_DIRECTORY_CONTROL, Nebenfunktionscode IRP_MN_NOTIFY_CHANGE_DIRECTORY empfangen.

Wenn NotifyIrpNULL ist, überprüft FsRtlNotifyFullChangeDirectory , ob die Benachrichtigungsliste einen ausstehenden IRP enthält, der auf dieses Dateiobjekt verweist, und schließt sie, falls ja, mit STATUS_DELETE_PENDING ab.

Wenn NotifyIrp nicht NULL ist, führt FsRtlNotifyFullChangeDirectory folgende Schritte aus:

  • Überprüft, ob das Dateiobjekt bereinigungen wurde. In diesem Fall schließt FsRtlNotifyFullChangeDirectory die Benachrichtigungs-IRP mit status STATUS_NOTIFY_CLEANUP ab.
  • Wenn das Dateiobjekt nicht bebereinigt wurde, überprüft FsRtlNotifyFullChangeDirectory , ob die Benachrichtigungsliste für dieses Volume bereits eine Benachrichtigungsstruktur für diese Änderung enthält. In diesem Fall schließt FsRtlNotifyFullChangeDirectory alle ausstehenden IRPs ab. Andernfalls markiert FsRtlNotifyFullChangeDirectory die Benachrichtigungs-IRP als ausstehend, erstellt eine Benachrichtigungsstruktur und fügt sie in die Liste ein.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header rxprocs.h (include Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL

SECURITY_SUBJECT_CONTEXT