FsRtlLookupPerStreamContext-Makro (ntifs.h)

Artikel
02/29/2024

Das FsRtlLookupPerStreamContext-Makro ruft eine Kontextstruktur pro Stream für einen Dateistream ab.

Syntax

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

Parameter

_sc

Zeiger auf die FSRTL_ADVANCED_FCB_HEADER-Struktur für den Dateidatenstrom. Verwenden Sie das FsRtlGetPerStreamContextPointer-Makro , um diesen Zeiger aus einem Dateiobjekt abzurufen.

_oid

Zeiger auf eine vom Aufrufer zugeordnete Variable, die den Besitzer der Kontextstruktur pro Stream eindeutig identifiziert. Das Format dieser Variablen ist filtertreiberspezifisch. Muss ungleich NULL sein, wenn für InstanceId ein Wert ungleich NULL angegeben wird.

_iid

Zeiger auf einen Filtertreiber – zugeordnete Variable, die verwendet werden kann, um zwischen Datenstromkontextstrukturen zu unterscheiden, die vom gleichen Filtertreiber erstellt wurden. Das Format dieser Variablen ist filtertreiberspezifisch.

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

Wenn ein Wert ungleich NULL für OwnerId und InstanceIdNULL angegeben wird, gibt FsRtlLookupPerStreamContext den ersten pro Stream gefundenen Kontext zurück, dessen OwnerId-Member mit dem OwnerId-Parameter übereinstimmt.

Rückgabewert

Keine

Bemerkungen

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

HinweisFsRtlLookupPerStreamContext kann nur in Dateisystemen verwendet werden, die Datenstromkontexte unterstützen.

Verwenden Sie zum Initialisieren einer Pro-Stream-Kontextstruktur das Makro FsRtlInitPerStreamContext .

Rufen Sie FsRtlInsertPerStreamContext auf, um eine initialisierte Pro-Stream-Kontextstruktur einem Dateidatenstrom zuzuordnen.

Um eine Stream-Kontextstruktur zu entfernen, die einem Dateidatenstrom zugeordnet ist, rufen Sie FsRtlRemovePerStreamContext auf.

Weitere Informationen finden Sie unter Nachverfolgen Per-Stream Kontexts in einem Legacy-Dateisystemfiltertreiber.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 SP4-Updaterollup; Windows XP
Zielplattform	Desktop
Kopfzeile	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL