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

指向 ULONG 类型的变量的指针,该变量接收 *ppvRestartBuffer指向的缓冲区的大小(以字节为单位)。 这是读取的重启记录的数据缓冲区的长度。

[out] plsnRestart

指向 CLFS_LSN 结构的指针,该结构接收已读取的重启记录的上一个 LSN。

返回值

ClfsReadPreviousRestartArea 如果成功,则返回STATUS_SUCCESS;否则,它将返回 Ntstatus.h 中定义的错误代码之一。 如果没有以前的重启区域,则返回值STATUS_LOG_START_OF_LOG。

言论

有关 CLFS 概念和术语的说明,请参阅 通用日志文件系统

有关从 CLFS 流读取记录的信息,请参阅 从 CLFS 流读取数据记录从 CLFS 流读取重启记录

读取上下文不是线程安全的。 客户端负责序列化对读取上下文的访问。

客户端通过调用 ClfsWriteRestartArea将重启记录追加到 CLFS 日志。

使用 ReadPreviousLogRestartArea 例程,客户端可以实现模糊检查点的形式。 例如,检查点状态可能包含由两条或更多条重启记录分隔的日志记录。

要求

要求 价值
最低支持的客户端 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中可用。
目标平台 桌面
标头 wdm.h (包括 Wdm.h)
Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另请参阅

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea