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

Zeigen Sie auf eine FS_FILTER_CALLBACKS-Struktur, die die Einstiegspunkte von caller-bereitgestellten Benachrichtigungsrückrufroutinen enthält. Alle Einstiegspunkte für Rückrufe sind optional und können auf NULL-festgelegt werden.

Rückgabewert

Die FsRtlRegisterFileSystemFilterCallbacks Routine kann einen der folgenden Statuswerte zurückgeben:

Bemerkungen

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

FsRtlRegisterFileSystemFilterCallbacks registriert die Benachrichtigungsrückrufroutinen, die im Callbacks Parameter 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 AcquireFileForNtCreateSectionzu 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

Siehe auch

FS_FILTER_CALLBACKS