FsRtlNotifyFilterReportChange-Funktion (ntifs.h)

  • Artikel

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

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL