共用方式為


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