ClfsReadNextLogRecord 函数 (wdm.h)
ClfsReadNextLogRecord 例程读取序列中的下一条记录,相对于读取上下文中的当前记录。
语法
CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
[in, out] PVOID pvReadContext,
[out] PVOID *ppvBuffer,
[out] PULONG pcbBuffer,
[in, out] PCLFS_RECORD_TYPE peRecordType,
[in, optional] PCLFS_LSN plsnUser,
[out] PCLFS_LSN plsnUndoNext,
[out] PCLFS_LSN plsnPrevious,
[out] PCLFS_LSN plsnRecord
);
参数
[in, out] pvReadContext
指向调用方先前通过调用 clfsReadLogRecord 或 ClfsReadRestartArea获取的读取上下文的指针。
[out] ppvBuffer
指向一个变量的指针,该变量接收指向包含记录数据的缓冲区的指针。
[out] pcbBuffer
指向 ULONG 类型的变量的指针,该变量接收 *ppvBuffer指向的缓冲区的大小(以字节为单位)。 这是记录读取的数据缓冲区的长度。
[in, out] peRecordType
指向CLFS_RECORD_TYPE类型的变量的指针。 调用方必须将此参数设置为以下值之一。
价值 | 将读取的记录 |
---|---|
ClfsDataRecord | 下一个数据记录。 |
ClfsRestartRecord | 下一次重启记录。 |
ClfsClientRecord | 下一条记录是数据记录或重启记录。 |
[in, optional] plsnUser
指向 CLFS_LSN 结构的指针,该结构提供要读取的记录的 LSN。 指定的记录是读取,而不是根据读取上下文的模式(ClfsContextUndoNext、ClfsContextPrevious或读取上下文的 ClfsContextForward) 读取的记录(pvReadContext)。 plsnUser 中提供的 LSN 必须小于读取上下文的当前 LSN。 此参数可以 NULL。
[out] plsnUndoNext
指向 CLFS_LSN 结构的指针,该结构接收读取的记录的撤消下一个 LSN。
[out] plsnPrevious
指向 CLFS_LSN 结构的指针,该结构接收所读取记录的上一个 LSN。
[out] plsnRecord
指向接收已读取记录 LSN 的 CLFS_LSN 结构的指针。
返回值
ClfsReadNextLogRecord 如果成功,则返回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 |