FsRtlLookupPerStreamContext-Makro (ntifs.h)

Artikel
02/07/2025

Das FsRtlLookupPerStreamContext Makro ruft eine Kontextstruktur pro Datenstrom für einen Dateidatenstrom ab.

Syntax

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

Parameter

_sc

Zeigen Sie auf die FSRTL_ADVANCED_FCB_HEADER Struktur für den Dateidatenstrom. Um diesen Zeiger aus einem Dateiobjekt abzurufen, verwenden Sie das FsRtlGetPerStreamContextPointer Makro.

_oid

Zeiger auf eine vom Aufrufer zugewiesene Variable, die den Besitzer der Kontextstruktur pro Datenstrom eindeutig identifiziert. Das Format dieser Variablen ist filtertreiber - spezifisch. Muss nichtNULL- sein, wenn für InstanceId-ein Nicht-NULL- wert angegeben wird.

_iid

Zeiger auf einen Filtertreiber – zugeordnete Variable, die verwendet werden kann, um zwischen datenstrombezogenen Kontextstrukturen zu unterscheiden, die vomselben Filtertreiber erstellt wurden. Das Format dieser Variablen ist filtertreiber - spezifisch.

Wenn OwnerId und InstanceId- beide NULL-sind, gibt FsRtlLookupPerStreamContext den ersten gefundenen Kontext pro Stream zurück.

Wenn für OwnerId ein nicht-NULL- wert angegeben wird und InstanceId-NULL-ist, gibt FsRtlLookupPerStreamContext den ersten Pro-Stream-Kontext zurück, der gefunden wurde, dessen OwnerId Member dem Parameter OwnerId entspricht.

Rückgabewert

Nichts

Bemerkungen

Ein Dateisystemfiltertreiber ruft FsRtlLookupPerStreamContext- auf, um die Kontextstruktur pro Stream für einen Dateidatenstrom abzurufen. Die Kontextstruktur pro Datenstrom enthält Kontextinformationen, die der Filtertreiber für den Dateidatenstrom verwaltet.

HinweisFsRtlLookupPerStreamContext- nur auf Dateisystemen verwendet werden kann, die Kontexte pro Stream unterstützen.

Um eine Kontextstruktur pro Datenstrom zu initialisieren, verwenden Sie das FsRtlInitPerStreamContext Makro.

Rufen Sie FsRtlInsertPerStreamContextauf, um eine initialisierte Kontextstruktur pro Datenstrom zuzuordnen.

Rufen Sie FsRtlRemovePerStreamContextauf, um eine Kontextstruktur pro Stream zu entfernen, die einem Dateidatenstrom zugeordnet ist.

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

Anforderungen

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