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 関数は次の手順に従う場合があります。
- OperationStatus パラメーターの値がエラー状態の場合は、 を返します。
- OperationStatus パラメーターの値がSTATUS_SUCCESS場合は、作業項目を作成してキューに入れ、処理を再開できることをクライアントに通知します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| IRQL | IRQL <= APC_LEVEL で呼び出されます |