FsRtlTeardownPerFileContexts-Funktion (ntifs.h)

  • Artikel

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

FSRTL_PER_FILE_CONTEXT

PFREE_FUNCTION

Nachverfolgen Per-File Kontexts in einem Legacy-Dateisystemfiltertreiber