ClfsReadRestartArea 関数 (wdm.h)
ClfsReadRestartArea ルーチンは、指定された CLFS ストリームに最後に書き込まれた再開レコードを読み取ります。
構文
CLFSUSER_API NTSTATUS ClfsReadRestartArea(
[in, out] PVOID pvMarshalContext,
[out] PVOID *ppvRestartBuffer,
[out] PULONG pcbRestartBuffer,
[out] PCLFS_LSN plsn,
[out] PVOID *ppvReadContext
);
パラメーター
[in, out] pvMarshalContext
CLFS ストリームに関連付けられたマーシャリング領域を表す不透明なコンテキストへのポインター。 呼び出し元は、ClfsCreateMarshallingArea 呼び出すことによって、このポインターを以前に取得しました。
[out] ppvRestartBuffer
再起動レコードのデータ バッファーへのポインターを受け取る変数へのポインター。
[out] pcbRestartBuffer
pcbRestartBuffer が指すデータ バッファーのサイズ (バイト単位) を受け取る ULONG 型変数へのポインター。 これは、再始動レコードのデータ・バッファーの長さです。
[out] plsn
読み取られた再始動レコードの LSN を受け取るCLFS_LSN構造体へのポインター。
[out] ppvReadContext
不透明な読み取りコンテキストへのポインターを受け取る変数へのポインター。 呼び出し元は、このコンテキストを ClfsReadPreviousRestartArea または clfsReadNextLogRecord 渡すことができます。 呼び出し元が読み取りコンテキストの使用を完了したら、ClfsTerminateReadLog 呼び出すことによってコンテキストを解放する必要があります。
戻り値
ClfsReadRestartArea 成功した場合、STATUS_SUCCESSが返されます。それ以外の場合は、Ntstatus.h で定義されているエラー コードのいずれかを返します。
備考
CLFS の概念と用語については、「共通ログ ファイル システムの」を参照してください。
CLFS ストリームからレコードを読み取る方法については、「CLFS ストリーム からのデータ レコードの読み取り」および「CLFS ストリーム からの再開レコードの読み取り」を参照してください。
読み取りコンテキストはスレッド セーフではありません。 クライアントは、読み取りコンテキストへのアクセスをシリアル化する役割を担います。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | wdm.h (Wdm.h を含む) |
| ライブラリ | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |
関連項目
clfsReadNextLogRecord の
ClfsReadPreviousRestartArea の