ClfsReserveAndAppendLogAligned 函数 (wdm.h)

ClfsReserveAndAppendLogAligned 例程在封送处理区域中保留空间，或将记录追加到封送处理区域，或者以原子方式执行这两种操作。 记录的数据在指定的边界上对齐。

语法

CLFSUSER_API NTSTATUS ClfsReserveAndAppendLogAligned(
  [in]            PVOID             pvMarshalContext,
  [in, optional]  PCLFS_WRITE_ENTRY rgWriteEntries,
  [in]            ULONG             cWriteEntries,
  [in]            ULONG             cbEntryAlignment,
  [in, optional]  PCLFS_LSN         plsnUndoNext,
  [in, optional]  PCLFS_LSN         plsnPrevious,
  [in]            ULONG             cReserveRecords,
  [in, out]       PLONGLONG         rgcbReservation,
  [in]            ULONG             fFlags,
  [out, optional] PCLFS_LSN         plsn
);

参数

[in] pvMarshalContext

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

[in, optional] rgWriteEntries

指向 CLFS_WRITE_ENTRY 结构的数组的指针，其中每个结构都包含指向数据缓冲区的指针，该缓冲区将成为附加到日志的记录的一部分。 如果 cWriteEntries 为零，此参数可以为 NULL。

[in] cWriteEntries

rgWriteEntries 指向的数组中的元素数。 如果 rgWriteEntries 为 NULL，此参数必须为 零。

[in] cbEntryAlignment

rgWriteEntries 指向的数据条目在封送到单个记录时所指向的字节对齐方式。 值 1 指定简单串联 (请参阅 ClfsReserveAndAppendLog) 。 大于 1 的值可能会导致记录中的条目之间放置零。 此参数的值必须大于零。

[in, optional] plsnUndoNext

指向 CLFS_LSN 结构的指针，该结构提供要追加的记录的撤消下一个 LSN。

[in, optional] plsnPrevious

指向CLFS_LSN结构的指针，该结构提供要追加的记录的上一个 LSN。

[in] cReserveRecords

rgcbReservation 指向的数组中的元素数。 如果 rgcbReservation 为 NULL 或设置了 fFlags 的CLFS_FLAG_USE_RESERVATION标志，则此参数必须为零。

[in, out] rgcbReservation

指向 LONGLONG 类型变量数组的指针。 调用方将数组的每个元素设置为必须为其保留空间的记录的大小（以字节为单位）。 返回时，每个数组元素接收为记录保留的空间的实际大小。 这包括标头和对齐方式所需的空间。 如果预留值为负值，则会释放与所提供的负值的绝对值最接近的保留记录。 如果 cReserveRecords 为零，此参数可以为 NULL;如果设置了 fFlags 的CLFS_FLAG_USE_RESERVATION标志，此参数必须为 NULL。

[in] fFlags

此参数可以是以下标志的任意组合。

[out, optional] plsn

指向 CLFS_LSN 结构的指针，该结构接收追加记录的 LSN。 如果 cWriteEntries 为零，此参数可以为 NULL。

返回值

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

注解

ClfsReserveAndAppendLogAligned 例程根据是否存在可选参数和CLFS_USE_RESERVATION标志的状态更改其基本行为。 下表汇总了常见方案。

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

要求

另请参阅

CLFS_LSN

CLFS_WRITE_ENTRY

ClfsCreateMarshallingArea

ClfsReserveAndAppendLog