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 概念和术语的说明,请参阅 通用日志文件系统。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | wdm.h (包括 Wdm.h) |
Library | Clfs.lib |
DLL | Clfs.sys |
IRQL | IRQL <= APC_LEVEL |