FsRtlTeardownPerFileContexts-Funktion (ntifs.h)
Dateisysteme rufen dieFsRtlTeardownPerFileContexts-Routine auf, um FSRTL_PER_FILE_CONTEXT Objekte frei zu geben, die einer FCB-Struktur (File Control Block) zugeordnet sind.
Syntax
void FsRtlTeardownPerFileContexts(
[in] PVOID *PerFileContextPointer
);
Parameter
[in] PerFileContextPointer
Ein Zeiger auf einen undurchsichtigen Zeiger, der die Kontextstruktur pro Datei identifiziert. Verwenden Sie zum Abrufen dieses Zeigers aus einem Dateiobjekt das Makro FsRtlGetPerFileContextPointer .
Rückgabewert
Keine
Bemerkungen
Diese Routine ruft die freeCallback-Routine auf, die im FSRTL_PER_FILE_CONTEXT-Objekt angegeben ist. Die FreeCallback-Routine muss die Zuordnung der FSRTL_PER_FILE_CONTEXT-Struktur und des zugeordneten Kontexts aufheben.
Um Konflikte bei der Synchronisierung zu vermeiden, gibt die FsRtlTeardownPerFileContexts-Routine vor dem Aufruf von FreeCallback die Sperre für die Kontextobjekte pro Datei frei. Dadurch wird verhindert, dass der Zugriff auf die Kontextobjekte pro Datei durch den Filter für eigene Listenvorgänge blockiert wird, z. B. das Entfernen mit FsRtlRemovePerFileContext.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar abWindows Vista. |
Zielplattform | Universell |
Header | ntifs.h (include FltKernel.h, Ntifs.h) |
Bibliothek | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <=APC_LEVEL |
Weitere Informationen
Nachverfolgen Per-File Kontexts in einem Legacy-Dateisystemfiltertreiber