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。 读取指定的记录，而不是根据读取上下文 (pvReadContext) 的模式 (ClfsContextUndoNext、ClfsContextPrevious 或 ClfsContextForward) 读取的记录。 plsnUser 中提供的 LSN 必须小于读取上下文的当前 LSN。 此参数可以为 NULL。

[out] plsnUndoNext

指向 CLFS_LSN 结构的指针，该结构接收读取的记录的撤消下一个 LSN。

[out] plsnPrevious

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

[out] plsnRecord

指向 CLFS_LSN 结构的指针，该结构接收读取的记录的 LSN。

返回值

ClfsReadNextLogRecord 如果成功，则返回STATUS_SUCCESS;否则，它将返回 Ntstatus.h 中定义的错误代码之一。

注解

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

有关从 CLFS 流读取记录的信息，请参阅从 CLFS Stream读取数据记录和从 CLFS Stream读取重启记录。

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

要求

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

另请参阅

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea