clfsFlushToLsn 函数 (wdm.h)

ClfsFlushToLsn 例程强制将 LSN 小于或等于指定 LSN 的所有记录强制到稳定的存储。

语法

CLFSUSER_API NTSTATUS ClfsFlushToLsn(
  [in]            PVOID     pvMarshalContext,
  [in]            PCLFS_LSN plsnFlush,
  [out, optional] PCLFS_LSN plsnLastFlushed
);

参数

[in] pvMarshalContext

指向与封送区域关联的不透明上下文的指针。 调用方以前通过调用 ClfsCreateMarshallingArea 获取了此指针。

[in] plsnFlush

指向 CLFS_LSN 结构的指针。 LSN 小于或等于 plsnFlush 的所有记录都保证强制使用稳定的存储。 如果 plsnFlush 等于 CLFS_LSN_NULL，则封送处理区域中的所有记录将强制到稳定的存储中。

[out, optional] plsnLastFlushed

指向 CLFS_LSN 结构的指针，该结构接收未刷新的最旧记录的 LSN。 这是紧接在刷新最后一条记录之后的记录的 LSN。

成功返回时， plsnLastFlushed 大于 plsnFlush 中提供的值。 但是， plsnLastFlushed 不一定指向流中的记录。 例如，如果已刷新流中的所有记录， 则 plsnLastFlushed 是将分配给写入到流的下一条记录的 LSN。

返回值

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

注解

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

要求

另请参阅

ClfsFlushBuffers