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 ストリーム からのデータ レコードの読み取り」および「CLFS ストリーム からの再開レコードの読み取り」を参照してください。

読み取りコンテキストはスレッド セーフではありません。 クライアントは、読み取りコンテキストへのアクセスをシリアル化する役割を担います。

クライアントは、clfsWriteRestartArea 呼び出すことによって、CLFS ログに再起動レコードを追加します。

ReadPreviousLogRestartArea ルーチンを使用すると、クライアントはあいまいチェックポイント処理の形式を実装できます。 たとえば、チェックポイントの状態は、2 つ以上の再起動レコードで区切られたログ レコードで構成できます。

必要条件

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

関連項目

CLFS_LSN

ClfsReadRestartArea の

ClfsWriteRestartArea の