FsRtlTeardownPerStreamContexts-Funktion (ntifs.h)

Artikel
12/21/2024

Die FsRtlTeardownPerStreamContexts Routine gibt alle Datenstromkontextstrukturen frei, die einer bestimmten FSRTL_ADVANCED_FCB_HEADER Struktur zugeordnet sind.

Syntax

void FsRtlTeardownPerStreamContexts(
  [in] PFSRTL_ADVANCED_FCB_HEADER AdvancedHeader
);

Parameter

[in] AdvancedHeader

Zeiger auf die FSRTL_ADVANCED_FCB_HEADER Struktur.

Rückgabewert

Nichts

Bemerkungen

Dateisysteme rufen FsRtlTeardownPerStreamContexts auf, um alle Datenstromkontextstrukturen freizugeben, die einer bestimmten FSRTL_ADVANCED_FCB_HEADER Struktur zugeordnet sind. Wenn ein Dateisystem das Streamkontextobjekt für einen Dateidatenstrom herunterreißt, muss es FsRtlTeardownPerStreamContextsaufrufen, wodurch wiederum die FreeCallback- Routinen aller datenstrombezogenen Kontextstrukturen aufgerufen werden, die dem Dateidatenstrom zugeordnet sind.

Um Konflikte bei der Synchronisierung zu vermeiden, gibt die FsRtlTeardownPerStreamContexts Routine die Sperre für die pro Dateikontextobjekte frei, bevor FreeCallback-aufgerufen wird. Dadurch wird verhindert, dass der Zugriff auf die pro Dateikontextobjekte durch den Filter für eigene Listenvorgänge blockiert wird, z. B. das Entfernen mit FsRtlRemovePerStreamContext.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 SP4 Update Rollup; Windows XP
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL