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 |