FltPrePrepareComplete 関数 (fltkernel.h)

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

FltPrePrepareComplete ルーチンは、TRANSACTION_NOTIFY_PREPREPARE通知を確認します。

構文

NTSTATUS FLTAPI FltPrePrepareComplete(
  [in]           PFLT_INSTANCE Instance,
  [in]           PKTRANSACTION Transaction,
  [in, optional] PFLT_CONTEXT  TransactionContext
);

パラメーター

[in] Instance

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

[in] Transaction

トランザクションの不透明なトランザクションポインター。

[in, optional] TransactionContext

ミニフィルタードライバーのトランザクションコンテキストへのポインター。

戻り値

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

リターンコード	説明
STATUS_NOT_FOUND	ミニフィルタードライバーは、トランザクションにコンテキストを設定しませんでした。これはエラーコードです。

注釈

トランザクションに参加しているミニフィルタードライバーは、トランザクションがコミットの事前準備フェーズに入ったときに、TRANSACTION_NOTIFY_PREPREPARE通知を受け取ることができます。ミニフィルタードライバーに通知を送信するには、フィルターマネージャーは、ミニフィルタードライバーの TransactionNotificationCallback ルーチンを 呼び出します。ミニフィルタードライバーは、次の 2 つの方法のいずれかでこの通知を確認します。

ミニフィルタードライバーの TransactionNotificationCallback ルーチンは、必要な処理を実行し、STATUS_SUCCESSを返します。この場合、ミニフィルタードライバーは FltPrePrepareComplete を呼び出しません。
ミニフィルタードライバーの TransactionNotificationCallback ルーチンは、必要な処理をワーカースレッドにポストし、STATUS_PENDINGを返します。非同期的に処理を実行した後、ミニフィルタードライバーの作業ルーチンは FltPrePrepareComplete を呼び出して、この処理が完了したことを示す必要があります。ミニフィルタードライバーの作業ルーチンが FltPrePrepareComplete を呼び出さない場合、トランザクションの事前準備操作はカーネルトランザクションマネージャーで完了できません。

TransactionNotificationCallback ルーチンを登録するために、ミニフィルタードライバーは、ミニフィルタードライバーが FltRegisterFilter の Registration パラメーターとして渡すFLT_REGISTRATION構造体の TransactionNotificationCallback メンバーにPFLT_TRANSACTION_NOTIFICATION_CALLBACK型のルーチンのアドレスを格納します。

トランザクションに参加するには、 FltEnlistInTransaction を呼び出します。

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

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

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

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

要件

要件	値
サポートされている最小のクライアント	このルーチンは、Windows Vista 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL