PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK コールバック関数 (wdm.h)

  • [アーティクル]

ClfsAdvanceTailCallback 関数は、クライアントのログの基本ログ シーケンス番号 (LSN) を進めます。

構文

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

NTSTATUS PclfsClientAdvanceTailCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] PCLFS_LSN TargetLsn,
  [in] PVOID ClientData
)
{...}

パラメーター

[in] LogFile

末尾を高度にする必要がある CLFS ログ ストリームを表す LOG_FILE_OBJECT 構造体へのポインター。

[in] TargetLsn

クライアントが末尾をまたはそれ以降に進める必要がある LSN を含む CLFS_LSN 構造体へのポインター。

[in] ClientData

クライアントが提供する情報へのポインター。 このデータは、CLFS_MGMT_CLIENT_REGISTRATION構造体の AdvanceTailCallbackData メンバーで指定します。

戻り値

ClfsAdvanceTailCallback 関数は、STATUS_PENDINGまたはエラー状態を返す必要があります。 STATUS_PENDING の戻り値は、クライアントのログ末尾を移動する要求が非同期的に完了することを示します。 ClfsMgmtAdvanceTailCallback 関数は、同期的に完了した場合でも、STATUS_SUCCESSを返してはなりません。

注釈

ClfsAdvanceTailCallback 関数は、CLFS 管理がクライアントにログ末尾を進める要求を行うと呼び出されます。

ClfsAdvanceTailCallback 関数は、 を返す前に最小限の処理のみを実行する必要があります。 たとえば、 ClfsAdvanceTailCallback 関数は次の手順に従う場合があります。

  1. 要求を処理できない場合は、エラー状態を返します。
  2. 要求を処理できる場合は、クライアントの末尾を移動するために必要なアクションを実行する作業項目を作成してキューに登録し、STATUS_PENDINGを返します。 ワーカー スレッドのキューの詳細については、「 システム ワーカー スレッド」を参照してください。
クライアントが ClfsMgmtRegisterManagedClient ルーチンを呼び出して CLFS 管理に登録すると、クライアントは ClfsAdvanceTailCallback 関数へのポインターと、この関数が呼び出されたときに ClfsAdvanceTailCallback 関数にパラメーターとして渡されるカスタム データの両方を提供します。

要件

要件 値
サポートされている最小のクライアント Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows でサポートされています。
対象プラットフォーム デスクトップ
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
IRQL IRQL <= APC_LEVEL で呼び出されます

こちらもご覧ください

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure