FsRtlNotifyFilterReportChange-Funktion (ntifs.h)
FsRtlNotifyFilterReportChange schließt IRP_MN_NOTIFY_CHANGE_DIRECTORY Anforderungen ab, die in der angegebenen Benachrichtigungsliste ausstehen.
Syntax
void FsRtlNotifyFilterReportChange(
[in] PNOTIFY_SYNC NotifySync,
[in] PLIST_ENTRY NotifyList,
[in] PSTRING FullTargetName,
[in] USHORT TargetNameOffset,
[in, optional] PSTRING StreamName,
[in, optional] PSTRING NormalizedParentName,
[in] ULONG FilterMatch,
[in] ULONG Action,
[in, optional] PVOID TargetContext,
[in, optional] PVOID FilterContext
);
Parameter
[in] NotifySync
Zeiger auf ein undurchsichtiges Synchronisierungsobjekt für die Änderungsverzeichnisbenachrichtigungsliste, auf die der NotifyList-Parameter verweist.
[in] NotifyList
Zeiger auf den Kopf der Änderungsverzeichnisbenachrichtigungsliste für das aktuelle Volume. Jedes Element in der Liste ist eine undurchsichtige Benachrichtigungsstruktur.
[in] FullTargetName
Zeiger auf eine ANSI- oder Unicode-Zeichenfolge, die den vollständigen Pfadnamen der geänderten Datei oder des Verzeichnisses enthält.
[in] TargetNameOffset
Offset in Byte innerhalb der FullTargetName-Zeichenfolge der letzten Komponente des Dateinamens für die Datei oder das Verzeichnis, die geändert wurde.
[in, optional] StreamName
Optionaler Zeiger auf eine ANSI- oder Unicode-Zeichenfolge, die einen Streamnamen enthält, der mit dem Dateinamen gespeichert werden soll.
[in, optional] NormalizedParentName
Optionaler Zeiger auf eine ANSI- oder Unicode-Zeichenfolge, die denselben Pfad wie in der FullTargetName-Zeichenfolge enthält, aber alle Kurznamen durch die entsprechenden langen Namen ersetzt werden.
[in] FilterMatch
Bitmaske von Flags, die mit dem Vervollständigungsfilter in der Benachrichtigungsstruktur verglichen werden sollen. Wenn eines der entsprechenden Bits im Vervollständigungsfilter festgelegt ist, ist eine Benachrichtigungsbedingung vorhanden. Mögliche Flagwerte finden Sie im CompletionFilter-Parameter von FsRtlNotifyFilterChangeDirectory.
[in] Action
Gibt den Aktionscode an, der im Puffer des Benutzers gespeichert werden soll, falls vorhanden. Mögliche Aktionscodewerte finden Sie im Action-Parameter von FsRtlNotifyFullReportChange.
[in, optional] TargetContext
Kontextzeiger, der an das Dateisystem übergeben werden soll, wenn eine Durchlaufüberprüfung durchgeführt wird, falls eine Struktur überwacht wird. Weitere Informationen finden Sie im TraverseCallback-Parameter von FsRtlNotifyFilterChangeDirectory.
[in, optional] FilterContext
Kontextzeiger, der an die Filterrückrufroutine übergeben werden soll. Weitere Informationen finden Sie im FilterCallback-Parameter von FsRtlNotifyFilterChangeDirectory.
Rückgabewert
Keine
Bemerkungen
Ein Dateisystem, das ein IRP mit Hauptfunktionscode IRP_MJ_DIRECTORY_CONTROL, Nebenfunktionscode IRP_MN_NOTIFY_CHANGE_DIRECTORY empfangen hat, ruft FsRtlNotifyFilterChangeDirectory auf, um eine Benachrichtigungsstruktur zu erstellen, die das IRP enthält, und die Benachrichtigungsstruktur der Benachrichtigungsliste für das aktuelle Volume hinzuzufügen.
Wenn eine Änderung am Verzeichnis auftritt, ruft das Dateisystem FsRtlNotifyFilterReportChange auf, um die ausstehenden IRP_MN_NOTIFY_CHANGE_DIRECTORY Anforderungen in der Benachrichtigungsliste abzuschließen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 SP4-Updaterollup; Windows XP |
Zielplattform | Universell |
Header | ntifs.h (include Ntifs.h) |
Bibliothek | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < APC_LEVEL |
DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |
Weitere Informationen
FsRtlNotifyFilterChangeDirectory
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für