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 つ以上の再起動レコードで区切られたログ レコードで構成できます。

要件

こちらもご覧ください

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea