FsRtlRegisterFileSystemFilterCallbacks-Funktion (ntifs.h)

Dateisystemfiltertreiber und Dateisysteme rufen die FsRtlRegisterFileSystemFilterCallbacks-Routine auf, um Benachrichtigungsrückrufroutinen zu registrieren, die aufgerufen werden sollen, wenn das zugrunde liegende Dateisystem bestimmte Vorgänge ausführt.

Syntax

NTSTATUS FsRtlRegisterFileSystemFilterCallbacks(
  [in] _DRIVER_OBJECT       *FilterDriverObject,
  [in] PFS_FILTER_CALLBACKS Callbacks
);

Parameter

[in] FilterDriverObject

Ein Zeiger auf das Treiberobjekt für den Filter- oder Dateisystemtreiber.

[in] Callbacks

Zeiger auf eine FS_FILTER_CALLBACKS-Struktur , die die Einstiegspunkte der vom Anrufer bereitgestellten Benachrichtigungsrückrufroutinen enthält. Alle Rückrufeinstiegspunkte sind optional und können auf NULL festgelegt werden.

Rückgabewert

Die FsRtlRegisterFileSystemFilterCallbacks-Routine kann einen der folgenden status-Werte zurückgeben:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Rückrufroutinen wurden erfolgreich registriert.
STATUS_INSUFFICIENT_RESOURCES	FsRtlRegisterFileSystemFilterCallbacks ist bei der Zuweisung von Arbeitsspeicher zum Speichern der Rückrufinformationen ein Poolzuordnungsfehler aufgetreten.
STATUS_FSFILTER_OP_COMPLETED_SUCCESSFULLY	FsRtlRegisterFileSystemFilterCallbacks hat einen FsFilter-Vorgang erfolgreich abgeschlossen.
STATUS_FILE_LOCKED_WITH_ONLY_READERS	Die Datei war gesperrt, und alle Benutzer der Datei können nur lesen.
STATUS_FILE_LOCKED_WITH_WRITERS	Die Datei war gesperrt, und mindestens ein Benutzer der Datei kann schreiben.
STATUS_INVALID_PARAMETER	Einer der Parameter ist ungültig.

Hinweise

Dateisystem- und Dateisystemfiltertreiber sollten FsRtlRegisterFileSystemFilterCallbacks aus der DriverEntry-Routine des Treibers aufrufen.

FsRtlRegisterFileSystemFilterCallbacks registriert die Benachrichtigungsrückrufroutinen, die im Callbacks-Parameter angegeben wurden, die aufgerufen werden sollen, wenn Anforderungen für bestimmte Dateivorgänge an das zugrunde liegende Dateisystem gesendet werden.

Dateisysteme rufen FsRtlRegisterFileSystemFilterCallbacks auf, um das PreAcquireForSectionSynchronization-Rückrufelement der FS_FILTER_CALLBACKS-Struktur festzulegen, anstatt die veraltete AcquireFileForNtCreateSection zu verwenden.

Die von FsRtlRegisterFileSystemFilterCallbacks registrierten Rückrufroutinen ersetzen die folgenden schnellen E/A-Rückrufroutinen, die veraltet sind und nicht von Dateisystemfiltertreibern verwendet werden sollten:

• AcquireForCcFlush
• AcquireFileForNtCreateSection
• AcquireForModWrite
• ReleaseForCcFlush
• ReleaseFileForNtCreateSection
• ReleaseForModWrite

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Weitere Informationen

FS_FILTER_CALLBACKS