структура CLS_INFORMATION (wdm.h)

Статья
02/27/2024

Структура 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

Набор флагов, определяющих атрибуты потока (или физического журнала). См. параметр fFlagsAndAttributes функции ClfsCreateLogFile .

FlushThreshold

Количество байтов данных (включая заголовки), которые могут оставаться в состоянии ожидания во внутренней очереди очистки, прежде чем CLFS автоматически запланирует поток для записи очереди очистки в стабильное хранилище.

SectorSize

Размер сектора (в байтах) базовой геометрии диска. Предполагается, что размер сектора кратен 512 и согласован в разных контейнерах.

MinArchiveTailLsn

Номер LSN самой старой записи в журнале, для которой не было архивирования. Минимальный и базовый номер LSN определяют последний контейнер, который можно использовать повторно при перезапуске контейнеров.

BaseLsn

Номер LSN самой старой записи в потоке (или физическом журнале), которая по-прежнему необходима клиентам потока (или журнала).

LastFlushedLsn

Номер LSN последней записи, которая была записана в стабильное хранилище.

LastLsn

Номер LSN самой молодой записи в потоке (или физическом журнале), которая по-прежнему необходима клиентам потока (или журнала).

RestartLsn

Номер LSN последней записи перезапуска, записанной в поток (или физический журнал). Если записей перезапуска нет, этот элемент равен CLFS_LSN_INVALID.

Identity

Guid, который служит уникальным идентификатором для журнала.

Если параметр eInformationClass равен ClfsLogBasicInformationPhysical, ClfsQueryLogFileInformation возвращает сведения в CLFS_INFORMATION структуре, а каждый элемент структуры содержит часть сведений о физическом журнале CLFS. Даже если журнал мультиплексирован (то есть содержит несколько потоков), все элементы структуры содержат сведения о базовом физическом журнале, а не об одном из потоков.

Если параметр eInformationClass равен ClfsLogBasicInformation, ClfsQueryLogFileInformation возвращает сведения в CLFS_INFORMATION структуре. Большинство элементов структуры содержат сведения о физическом журнале CLFS, но если журнал мультиплексирован, некоторые элементы содержат сведения, относящиеся к конкретному потоку. Следующие элементы структуры содержат сведения, относящиеся к потоку, а не базовому физическому журналу: