CLS_INFORMATION 구조체(wdm.h)

CLFS_INFORMATION 구조는 CLFS(Common Log File System) 스트림 및/또는 기본 물리적 로그에 대한 메타데이터 및 상태 정보를 보유합니다.

구문

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