FltGetInstanceContext-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltGetInstanceContext Routine ruft einen Kontext ab, der für eine Instanz durch einen bestimmten Minifiltertreiber festgelegt wurde.

Syntax

NTSTATUS FLTAPI FltGetInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *Context
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für die Instanz.

[out] Context

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

Rückgabewert

FltGetInstanceContext gibt STATUS_SUCCESS zurück, wenn der angeforderte Instanzkontext erfolgreich zurückgegeben wird. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B. folgendes:

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Zu diesem Zeitpunkt wurde kein übereinstimmenden Kontext für diese Instanz gefunden. FltMgr legt Context auf NULL_CONTEXT fest. Dies ist ein Fehlercode.

Bemerkungen

Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.

FltGetInstanceContext ruft einen Kontext ab, der für eine Instanz durch einen bestimmten Minifiltertreiber festgelegt wurde.

FltGetInstanceContext die Verweisanzahl im 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 FltGetInstanceContext mit einem nachfolgenden Aufruf von FltReleaseContextabgeglichen werden.

Um einen Kontext für eine Instanz festzulegen, rufen Sie FltSetInstanceContextauf.

Rufen Sie FltAllocateContextauf, um einen neuen Kontext zuzuweisen.

Rufen Sie zum Löschen eines Dateikontexts FltDeleteInstanceContext oder FltDeleteContext-auf.