CLS_INFORMATION 结构 (wdm.h)

  • 项目

CLFS_INFORMATION 结构保存通用日志文件系统 (CLFS) 流和/或其基础物理日志的元数据和状态信息。

语法

typedef struct _CLS_INFORMATION {
  LONGLONG  TotalAvailable;
  LONGLONG  CurrentAvailable;
  LONGLONG  TotalReservation;
  ULONGLONG BaseFileSize;
  ULONGLONG ContainerSize;
  ULONG     TotalContainers;
  ULONG     FreeContainers;
  ULONG     TotalClients;
  ULONG     Attributes;
  ULONG     FlushThreshold;
  ULONG     SectorSize;
  CLS_LSN   MinArchiveTailLsn;
  CLS_LSN   BaseLsn;
  CLS_LSN   LastFlushedLsn;
  CLS_LSN   LastLsn;
  CLS_LSN   RestartLsn;
  GUID      Identity;
} CLS_INFORMATION, *PCLS_INFORMATION, *PPCLS_INFORMATION;

成员

TotalAvailable

分配给日志的总可用空间。 这按日志中所有容器的大小之和计算。

CurrentAvailable

日志中可用于新记录和预留分配的空间量。 此空间是总可用空间减去撤消承诺空间和用于在多路复用日志中存储所有者页面的空间。

TotalReservation

流 (或物理日志中保留的空间量) 撤消操作。

BaseFileSize

基本日志文件的大小（以字节为单位）。

ContainerSize

日志中单个容器的大小（以字节为单位）。 请注意，日志中的所有容器的大小相同。

TotalContainers

日志中的容器数。

FreeContainers

日志中未处于活动状态的容器数。

TotalClients

共享日志的流数。

Attributes

一组标志，用于指定流 (或物理日志) 属性。 请参阅 ClfsCreateLogFile 函数的 fFlagsAndAttributes 参数。

FlushThreshold

数据字节数 (包括允许在内部刷新队列上保持挂起的标头) ，然后 CLFS 自动计划线程以将刷新队列写入稳定存储。

SectorSize

基础磁盘几何图形的扇区大小（以字节为单位）。 扇区大小假定为 512 的倍数，并且跨容器一致。

MinArchiveTailLsn

日志中尚未进行存档的最早记录的 LSN。 此和基本 LSN 的最小值决定了在回收容器时可以重复使用的最后一个容器。

BaseLsn

流中最早记录的 LSN (或物理日志) ，流 (或日志) 客户端仍需要该记录。

LastFlushedLsn

刷新到稳定存储的最后一条记录的 LSN。

LastLsn

流中最年轻的记录 (或物理日志) 的 LSN，流 (或日志) 客户端仍需要该记录。

RestartLsn

写入流 (或物理日志) 的最后一个重启记录的 LSN。 如果没有重启记录，则此成员等于CLFS_LSN_INVALID。

Identity

用作日志的唯一标识符的 GUID。

注解

ClfsQueryLogFileInformation 函数返回有关 CLFS 流和/或其基础物理日志的信息。 返回的信息类型取决于 eInformationClass 参数。

如果 eInformationClass 参数等于 ClfsLogBasicInformationPhysical， 则 ClfsQueryLogFileInformation 返回 CLFS_INFORMATION 结构中的信息，并且每个结构成员包含有关物理 CLFS 日志的信息。 即使日志是多路复用 (即，它也有多个流) ，所有结构成员都保存有关基础物理日志的信息，而不是有关其中一个流的信息。

如果 eInformationClass 参数等于 ClfsLogBasicInformation， 则 ClfsQueryLogFileInformation 返回 CLFS_INFORMATION 结构中的信息。 大多数结构成员保存有关 CLFS 物理日志的信息，但如果日志是多路复用的，则某些成员保存特定于特定流的信息。 以下结构成员保存特定于流而不是基础物理日志的信息：

  • TotalUndoCommitment
  • 特性
  • BaseLsn
  • LastLsn
  • RestartLsn

要求

要求 值
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）

另请参阅

ClfsCreateLogFile

ClfsQueryLogFileInformation

ClfsSetLogFileInformation