次の方法で共有


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されている場合は、作業項目を作成してキューに入れ、処理を再開できることをクライアントに通知します。
クライアントが CLFS 管理に登録するために ClfsMgmtRegisterManagedClient ルーチンを使用する場合、クライアントは、ClfsLogGrowthCompleteCallback 関数へのポインターと、この関数が呼び出されたときに ClfsLogGrowthCompleteCallback 関数にパラメーターとして渡されるカスタム データの両方を提供します。

必要条件

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

関連項目

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient