FltGetStreamHandleContext-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltGetStreamHandleContext Routine ruft einen Kontext ab, der für ein Streamhandle von einer bestimmten Minifiltertreiberinstanz festgelegt wurde.

Syntax

NTSTATUS FLTAPI FltGetStreamHandleContext(
  [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 das Datenstromhandle.

[out] Context

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

Rückgabewert

FltGetStreamHandleContext- 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.

FltGetStreamHandleContext ruft einen Kontext ab, der für ein Datenstromhandle von einem bestimmten Minifiltertreiber festgelegt wurde.

FltGetStreamHandleContext erhöht die Verweisanzahl für den Kontext, 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 FltGetStreamHandleContext- mit einem nachfolgenden Aufruf von FltReleaseContextabgeglichen werden.

Um einen Kontext für ein Datenstromhandle festzulegen, rufen Sie FltSetStreamHandleContext-

Rufen Sie FltAllocateContextauf, um einen neuen Kontext zuzuweisen.

Rufen Sie zum Löschen eines Streamhandle-Kontexts FltDeleteStreamHandleContext oder FltDeleteContext-auf.