FltGetStreamContext-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltGetStreamContext Routine ruft einen Kontext ab, der für einen Dateidatenstrom von einer bestimmten Minifiltertreiberinstanz festgelegt wurde.

Syntax

NTSTATUS FLTAPI FltGetStreamContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für die Minifiltertreiberinstanz, deren Kontext abgerufen werden soll.

[in] FileObject

Zeigen Sie auf ein Dateiobjekt für den Datenstrom.

[out] Context

Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Adresse des Kontexts empfängt. Dieser Parameter ist erforderlich und kann nicht auf NULL festgelegt werden.

Rückgabewert

FltGetStreamContext gibt STATUS_SUCCESS zurück, wenn der angeforderte Kontext erfolgreich zurückgegeben wird. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Derzeit wurde in dieser Datei kein Abgleichskontext gefunden, sodass FltMgrContext auf NULL_CONTEXT festlegen. Dies ist ein Fehlercode.
STATUS_NOT_SUPPORTED	Das Dateisystem unterstützt keine Datenstromkontexte für diesen Dateidatenstrom. Dies ist ein Fehlercode.

Bemerkungen

Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.

FltGetStreamContext ruft einen Kontext ab, der für einen Dateidatenstrom von einer bestimmten Minifiltertreiberinstanz festgelegt wurde.

FltGetStreamContext die Verweisanzahl für den Kontext erhöht, auf den der Context Parameter verweist. Wenn dieser Kontextzeiger nicht mehr benötigt wird, muss der Aufrufer seine Verweisanzahl erhöhen, indem FltReleaseContext-aufgerufen wird. Daher muss jeder erfolgreiche Aufruf von FltGetStreamContext durch einen nachfolgenden Aufruf von FltReleaseContextabgeglichen werden.

Rufen Sie FltSetStreamContextauf, um einen Kontext für einen Dateidatenstrom festzulegen.

Rufen Sie FltAllocateContextauf, um einen neuen Kontext zuzuweisen.

Rufen Sie zum Löschen eines Datenstromkontexts FltDeleteStreamContext oder FltDeleteContext-auf.