clfsWriteRestartArea 函数 (wdm.h)

项目
02/29/2024

ClfsWriteRestartArea 例程以原子方式将新的重启记录追加到 CLFS 流，将重启记录刷新到稳定存储，并选择性地更新流的基本 LSN。

语法

CLFSUSER_API NTSTATUS ClfsWriteRestartArea(
  [in, out]       PVOID     pvMarshalContext,
  [in]            PVOID     pvRestartBuffer,
  [in]            ULONG     cbRestartBuffer,
  [in, optional]  PCLFS_LSN plsnBase,
  [in]            ULONG     fFlags,
  [out, optional] PULONG    pcbWritten,
  [out, optional] PCLFS_LSN plsnNext
);

参数

[in, out] pvMarshalContext

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

[in] pvRestartBuffer

指向包含重启记录数据的缓冲区的指针。

[in] cbRestartBuffer

pvRestartBuffer 指向的缓冲区的大小（以字节为单位）。这是重启数据的大小。

[in, optional] plsnBase

指向 CLFS_LSN 结构的指针，该结构指定流的新基 LSN。如果此参数为 NULL，则基本 LSN 不会更改。

[in] fFlags

此参数须为下列值之一。

值	含义
0	重启记录放置在 I/O 块中新分配的空间中。封送处理区域中保留的记录数不会更改。
CLFS_FLAG_USE_RESERVATION	重启记录放置在 I/O 块中以前保留的空间中。封送处理区域中的保留记录数减少 1。

[out, optional] pcbWritten

指向 ULONG 类型变量的指针，该变量接收实际强制到稳定存储的字节数。此参数可以为 NULL。

[out, optional] plsnNext

指向 CLFS_LSN 结构的指针，该结构接收新写入的重启记录的 LSN。

返回值

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

注解

通常，ClfsWriteRestartArea 将作为客户端检查点的最后一个操作调用。

ClfsWriteRestartArea 是一个相对昂贵的操作，因为它会导致刷新当前位于封送处理区域中的所有记录，同时刷新流和日志元数据。

在任何时候，只应使用一个封送区域将数据写入流。将两个封送区域写入流可能会导致流损坏。

如果只想设置流的基 LSN，请使用 ClfsAdvanceLogBase，这不一定会将任何数据刷新到稳定存储。

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

要求

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