FltGetTransactionContext-Funktion (fltkernel.h)

Artikel
02/26/2024

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

Syntax

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

Parameter

[in] Instance

Undurchsichtiger instance Zeiger für den Aufrufer.

[in] Transaction

Undurchsichtiger Transaktionszeiger für die Transaktion, deren Kontext abgerufen wird.

[out] Context

Zeiger auf eine vom Aufrufer zugeordnete Variable, die die Adresse des Transaktionskontexts empfängt.

Rückgabewert

FltGetTransactionContext gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. den folgenden:

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Es wurde kein übereinstimmenden Kontext gefunden. Dies ist ein Fehlercode.

Hinweise

Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.

FltGetTransactionContext 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 FltGetTransactionContext durch einen nachfolgenden Aufruf von FltReleaseContext abgeglichen werden.

Um einen Kontext für eine Transaktion festzulegen, rufen Sie FltSetTransactionContext auf.

Um einen neuen Transaktionskontext zuzuordnen, rufen Sie FltAllocateContext auf.

Um einen Transaktionskontext zu löschen, rufen Sie FltDeleteTransactionContext oder FltDeleteContext auf.