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

要件

要件 値
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

こちらもご覧ください

ClfsCreateLogFile

ClfsQueryLogFileInformation

ClfsSetLogFileInformation