FltGetInstanceContext-Funktion (fltkernel.h)

Artikel
02/26/2024

Die FltGetInstanceContext-Routine ruft einen Kontext ab, der für eine instance von einem bestimmten Minifiltertreiber festgelegt wurde.

Syntax

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

Parameter

[in] Instance

Undurchsichtiger instance Zeiger für die instance.

[out] Context

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

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Auf diesem instance wurde zu diesem Zeitpunkt kein übereinstimmenden Kontext gefunden. FltMgr legt Kontext auf NULL_CONTEXT fest. Dies ist ein Fehlercode.

Hinweise

Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.

FltGetInstanceContext ruft einen Kontext ab, der für eine instance von einem bestimmten Minifiltertreiber festgelegt wurde.

FltGetInstanceContext 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 durch Aufrufen von FltReleaseContext verringern. Daher muss jeder erfolgreiche Aufruf von FltGetInstanceContext durch einen nachfolgenden Aufruf von FltReleaseContext abgeglichen werden.

Um einen Kontext für eine instance festzulegen, rufen Sie FltSetInstanceContext auf.

Um einen neuen Kontext zuzuordnen, rufen Sie FltAllocateContext auf.

Um einen Dateikontext zu löschen, rufen Sie FltDeleteInstanceContext oder FltDeleteContext auf.