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 Stream读取数据记录和从 CLFS Stream读取重启记录。
读取上下文不是线程安全的。 客户端负责序列化对读取上下文的访问。
客户端通过调用 ClfsWriteRestartArea 将重启记录追加到 CLFS 日志。
使用 ReadPreviousLogRestartArea 例程,客户端可以实现某种形式的模糊检查点。 例如,检查点状态可能包含由两个或多个重启记录分隔的日志记录。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | wdm.h (包括 Wdm.h) |
Library | Clfs.lib |
DLL | Clfs.sys |
IRQL | <= APC_LEVEL |