FltGetTransactionContext 関数 (fltkernel.h)

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をします。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	fltkernel.h (Fltkernel.h を含む)
ライブラリ	FltMgr.lib
DLL	FltMgr.sys
IRQL	<= APC_LEVEL

関連項目

FltAllocateContextの

FltCommitCompleteをする

FltDeleteContextの

FltDeleteTransactionContextをする

FltEnlistInTransactionをする

FltPrePrepareCompleteをする

FltPrepareCompleteをする

FltReleaseContextの

FltRollbackCompleteの

FltRollbackEnlistmentをする

FltSetTransactionContextの