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

  • [アーティクル]

ClfsLogGrowthCompleteCallback 関数は、以前にいっぱいだったログで領域が解放されたときにクライアントが実行するアクションを実装します。

構文

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

void PclfsClientLffHandlerCompleteCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] NTSTATUS OperationStatus,
  [in] BOOLEAN LogIsPinned,
  [in] PVOID ClientData
)
{...}

パラメーター

[in] LogFile

ログの増加が完了した CLFS ログ ストリームを表す LOG_FILE_OBJECT 構造体へのポインター。

[in] OperationStatus

ログ ファイルの完全な状態を処理するためのクライアントの以前の要求の状態。 これは、STATUS_SUCCESSか、要求が正常に完了できなかった理由を示すエラー状態になります。

[in] LogIsPinned

TRUE の場合は、ログ末尾が現在固定されていることを指定します。ログ末尾が固定されていない場合は FALSE。

[in] ClientData

クライアントが提供する情報へのポインター。

戻り値

なし

解説

ClfsMgmtHandleLogFileFull の呼び出しは非同期的に完了するため、ログ ファイルの完全な条件が処理されたときにクライアントが実行するすべてのアクションは、ClfsLogGrowthCompleteCallback 関数に属します。

返された ClfsMgmtHandleLogFileFull ルーチンの呼び出しがSTATUS_PENDINGを返した場合、操作の完了時に ClfsLogGrowthCompleteCallback 関数が呼び出されます。 別の状態が返された場合、 ClfsLogGrowthCompleteCallback 関数は呼び出されません。

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

  1. OperationStatus パラメーターの値がエラー状態の場合は、 を返します。
  2. OperationStatus パラメーターの値がSTATUS_SUCCESS場合は、作業項目を作成してキューに入れ、処理を再開できることをクライアントに通知します。
クライアントが ClfsMgmtRegisterManagedClient ルーチンを使用して CLFS 管理に登録する場合、クライアントは ClfsLogGrowthCompleteCallback 関数へのポインターと、この関数が呼び出されたときに ClfsLogGrowthCompleteCallback 関数にパラメーターとして渡されるカスタム データの両方を提供します。

要件

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

こちらもご覧ください

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient