FltGetTransactionContext-Funktion (fltkernel.h)
Die FltGetTransactionContext Routine ruft einen Kontext ab, der für eine Transaktion durch einen bestimmten Minifiltertreiber festgelegt wurde.
Syntax
NTSTATUS FLTAPI FltGetTransactionContext(
[in] PFLT_INSTANCE Instance,
[in] PKTRANSACTION Transaction,
[out] PFLT_CONTEXT *Context
);
Parameter
[in] Instance
Undurchsichtiger Instanzzeiger für den Aufrufer.
[in] Transaction
Undurchsichtiger Transaktionszeiger für die Transaktion, deren Kontext abgerufen wird.
[out] Context
Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Adresse des Transaktionskontexts empfängt.
Rückgabewert
FltGetTransactionContext gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück, z. B. folgendes:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_NOT_FOUND | Es wurde kein übereinstimmenden Kontext gefunden. Dies ist ein Fehlercode. |
Bemerkungen
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 erhöhen, indem FltReleaseContext-aufgerufen wird. Daher muss jeder erfolgreiche Aufruf von FltGetTransactionContext mit einem nachfolgenden Aufruf von FltReleaseContextabgeglichen werden.
Um einen Kontext für eine Transaktion festzulegen, rufen Sie FltSetTransactionContextauf.
Rufen Sie FltAllocateContextauf, um einen neuen Transaktionskontext zuzuweisen.
Rufen Sie zum Löschen eines Transaktionskontexts FltDeleteTransactionContext oder FltDeleteContext-auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL- | FltMgr.sys |
| IRQL- | <= APC_LEVEL |