FltCommitComplete 関数 (fltkernel.h)

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

FltCommitComplete ルーチンは、TRANSACTION_NOTIFY_COMMIT通知を確認します。

構文

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

パラメーター

[in] Instance

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

[in] Transaction

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

[in, optional] TransactionContext

トランザクションのミニフィルタードライバーのコンテキストへのポインター。このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

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

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

注釈

このルーチンは、Windows Vista 以降で使用できます。

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

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

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

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

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

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

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

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