次の方法で共有

FltSetTransactionContext 関数 (fltkernel.h)

  • [アーティクル]

FltSetTransactionContext ルーチンは、トランザクションにコンテキストを設定します。

構文

NTSTATUS FLTAPI FltSetTransactionContext(
  [in]            PFLT_INSTANCE             Instance,
  [in]            PKTRANSACTION             Transaction,
  [in]            FLT_SET_CONTEXT_OPERATION Operation,
  [in]            PFLT_CONTEXT              NewContext,
  [out, optional] PFLT_CONTEXT              *OldContext
);

パラメーター

[in] Instance

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

[in] Transaction

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

[in] Operation

実行する操作の詳細を指定するフラグ。 このパラメーターは、次のいずれかである必要があります。

旗 意味
FLT_SET_CONTEXT_REPLACE_IF_EXISTS Transaction パラメーターが指すトランザクションに対してコンテキストが既に設定されている場合、FltSetTransactionContext は、NewContext パラメーターが指すコンテキストに置き換えられます。 それ以外の場合は、NewContext パラメーターが指すコンテキストを、Transaction パラメーターが指すトランザクションのコンテキストとして設定します。
FLT_SET_CONTEXT_KEEP_IF_EXISTS Transaction パラメーターが指すトランザクションに対してコンテキストが既に設定されている場合、FltSetTransactionContext はSTATUS_FLT_CONTEXT_ALREADY_DEFINEDを返し、既存のコンテキストを置き換えたり、参照カウントをインクリメントしたりしません。 コンテキストがまだ設定されていない場合、このルーチンは、NewContext パラメーターが指すコンテキストを、Transaction パラメーターが指すトランザクションのコンテキストとして設定し、参照カウントをインクリメントします。

[in] NewContext

トランザクションに設定する新しいコンテキストへのポインター。 このパラメーターは必須であり、NULL することはできません。

[out, optional] OldContext

既存のトランザクション コンテキストのアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター (既に設定されている場合)。 このパラメーターは省略可能であり、NULL できます。 このパラメーターの詳細については、次の「解説」セクションを参照してください。

戻り値

FltSetTransactionContext は、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターン コード 形容
STATUS_FLT_CONTEXT_ALREADY_DEFINED Operation パラメーターにFLT_SET_CONTEXT_KEEP_IF_EXISTSが指定されている場合、このエラー コードは、コンテキストがトランザクションに既にアタッチされていることを示します。 特定のミニフィルター ドライバーのトランザクションにアタッチできるコンテキストは 1 つだけです。
STATUS_FLT_CONTEXT_ALREADY_LINKED NewContext パラメーターが指すコンテキストは、既にオブジェクトにリンクされています。 言い換えると、このエラー コードは、FltSetXxxコンテキスト ルーチンが正常に呼び出されたため、NewContext が既に使用されていることを示します。
STATUS_FLT_DELETING_OBJECT
Instance パラメーターで指定されたインスタンスが切断されています。 これはエラー コードです。
STATUS_INVALID_PARAMETER 無効なパラメーターが渡されました。 たとえば、NewContext パラメーターが有効なトランザクション コンテキストを指していないか、Operation パラメーターに無効な値が指定されています。 これはエラー コードです。

備考

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

ミニフィルター ドライバーは、FltSetTransactionContext 呼び出して、トランザクションにコンテキストをアタッチするか、既存のトランザクション コンテキストを削除または置換します。 ミニフィルター ドライバーは、特定のトランザクションに 1 つのコンテキストのみをアタッチできます。

参照カウント

FltSetTransactionContext 成功した場合:

  • NewContext の参照カウントがインクリメントされます。 NewContext 不要になった場合、ミニフィルターは FltReleaseContext呼び出して参照カウントを減らす必要があります。

FltSetTransactionContext 失敗した場合は、次のようになります。

  • NewContext の参照カウントは変更されません。
  • OldContext が NULL ではなく、NULL_CONTEXTを指していない場合、OldContext は、現在トランザクションに関連付けられているコンテキストへの参照ポインターです。 FltSetTransactionContext 呼び出すフィルターは、コンテキスト ポインターが不要になった場合に、OldContext の FltReleaseContext 呼び出す必要があります。

成功に関係なく:

詳細については、「コンテキストの参照」を参照してください。

その他のコンテキスト操作

詳細については、「コンテキストの設定」および「コンテキストの解放」を参照してください。

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

トランザクション コンテキストを取得するには、FltGetTransactionContext呼び出します。

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降のオペレーティング システムで使用可能でサポートされています。
ターゲット プラットフォーム の 万国
ヘッダー fltkernel.h (Fltkernel.h を含む)
ライブラリ FltMgr.lib
DLL FltMgr.sys
IRQL <= APC_LEVEL。

関連項目

FltAllocateContextの

FltCommitCompleteをする

FltDeleteContextの

FltDeleteTransactionContextをする

FltEnlistInTransactionをする

FltGetTransactionContextの

FltPrePrepareCompleteをする

FltPrepareCompleteをする

FltReleaseContextの

FltRollbackCompleteの

FltRollbackEnlistmentをする