FsRtlGetPerStreamContextPointer-Makro (ntifs.h)

Artikel
02/07/2025

Das FsRtlGetPerStreamContextPointer Makro gibt den Datenstromkontext des Dateisystems für einen Dateidatenstrom zurück.

Syntax

void FsRtlGetPerStreamContextPointer(
   _fo
);

Parameter

_fo

Zeigen Sie auf ein Dateiobjekt für den Dateidatenstrom.

Rückgabewert

Nichts

Bemerkungen

Dateisystemfiltertreiber können das FsRtlGetPerStreamContextPointer Makro verwenden, um einen Datenstromkontextzeiger für den Dateidatenstrom abzurufen, der durch ein bestimmtes Dateiobjekt dargestellt wird. Ein Streamkontextzeiger ist ein Zeiger auf den Datenstromkontext des Dateisystems für den Dateistream. Dieser Zeiger kann als Parameter an FsRtlInsertPerStreamContext, FsRtlLookupPerStreamContextund FsRtlRemovePerStreamContextübergeben werden.

Der Streamkontextzeiger verweist auf eine FSRTL_ADVANCED_FCB_HEADER Struktur, die den Dateidatenstrom eindeutig auf das Dateisystem identifiziert. Diese Struktur wird in der Regel in ein Datenstromkontextobjekt eingebettet, z. B. in einen Dateisteuerungsblock (File Control Block, FCB) oder in einen Datenstromsteuerungsblock (Stream Control Block, SCB). Wenn der Dateidatenstrom geöffnet wird, speichert das Dateisystem einen Zeiger auf den FCB oder SCB im FsContext Member des Dateiobjekts.

Hinweis Das FsRtlGetPerStreamContextPointer- Makro kann nur für Dateisysteme verwendet werden, die erweiterte FCB-Header unterstützen.

Weitere Informationen finden Sie unter Tracking Per-Stream Context in einem Legacy File System Filter Driver.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP; Windows 2000 SP4 UpdateRollup
Zielplattform-	Desktop
Header-	ntifs.h (einschließlich Ntifs.h)
IRQL-	<= APC_LEVEL