ClfsReadPreviousRestartArea 関数 (wdm.h)
ClfsReadPreviousRestartArea ルーチンは、読み取りコンテキストの現在のレコードを基準にして、前の再起動レコードを読み取ります。
構文
CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
[in] PVOID pvReadContext,
[out] PVOID *ppvRestartBuffer,
[out] PULONG pcbRestartBuffer,
[out] PCLFS_LSN plsnRestart
);
パラメーター
[in] pvReadContext
ClfsReadRestartArea の以前の呼び出しによって取得された読み取りコンテキストへのポインター。
[out] ppvRestartBuffer
読み取られた再始動レコードのデータ・バッファーへのポインターを受け取る変数へのポインター。
[out] pcbRestartBuffer
*ppvRestartBuffer が指すバッファーのサイズ (バイト単位) を受け取る ULONG 型の変数へのポインター。 これは、読み取られた再始動レコードのデータ・バッファーの長さです。
[out] plsnRestart
読み取られた再始動 レコードの前 の LSN を受け取るCLFS_LSN構造体へのポインター。
戻り値
ClfsReadPreviousRestartArea は、成功した場合STATUS_SUCCESSを返します。それ以外の場合は、Ntstatus.h で定義されているエラー コードのいずれかを返します。 以前の再起動領域がない場合、戻り値はSTATUS_LOG_START_OF_LOG。
注釈
CLFS の概念と用語の説明については、「 共通ログ ファイル システム」を参照してください。
CLFS ストリームからレコードを読み取る方法については、「CLFS Streamからのデータ レコードの読み取り」および「CLFS Streamからの再開レコードの読み取り」を参照してください。
読み取りコンテキストはスレッド セーフではありません。 クライアントは、読み取りコンテキストへのアクセスをシリアル化する役割を担います。
クライアントは、 ClfsWriteRestartArea を呼び出して、CLFS ログに再起動レコードを追加します。
ReadPreviousLogRestartArea ルーチンを使用すると、クライアントはあいまいチェックポイント処理の形式を実装できます。 たとえば、チェックポイントの状態は、2 つ以上の再起動レコードで区切られたログ レコードで構成できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wdm.h (Wdm.h を含む) |
| Library | Clfs.lib |
| [DLL] | Clfs.sys |
| IRQL | <= APC_LEVEL |