FltGetTransactionContext 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltGetTransactionContext ルーチンは、特定のミニフィルタードライバーによってトランザクションに設定されたコンテキストを取得します。

構文

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

パラメーター

[in] Instance

呼び出し元の不透明なインスタンスポインター。

[in] Transaction

コンテキストが取得されるトランザクションの不透明なトランザクションポインター。

[out] Context

トランザクションコンテキストのアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター。

戻り値

FltGetTransactionContext は 、次のようなSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_NOT_FOUND	一致するコンテキストが見つかりませんでした。これはエラーコードです。

注釈

コンテキストの詳細については、「ミニフィルターコンテキストについて」を参照してください。

FltGetTransactionContext は、Context パラメーターが指すコンテキストの参照カウントをインクリメントします。このコンテキストポインターが不要になった場合、呼び出し元は FltReleaseContext を呼び出して参照カウントをデクリメントする必要があります。したがって、 FltGetTransactionContext の呼び出しが成功するたびに、 FltReleaseContext の後続の呼び出しと一致する必要があります。

トランザクションのコンテキストを設定するには、 FltSetTransactionContext を呼び出します。

新しいトランザクションコンテキストを割り当てるには、 FltAllocateContext を呼び出します。

トランザクションコンテキストを削除するには、 FltDeleteTransactionContext または FltDeleteContext を呼び出します。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	FltMgr.sys
IRQL	<= APC_LEVEL