estrutura CLS_INFORMATION (wdm.h)

A estrutura CLFS_INFORMATION contém metadados e informações de estado para um fluxo CLFS (Common Log File System) e/ou seu log físico subjacente.

Sintaxe

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;

Membros

TotalAvailable

O espaço total disponível alocado para o log. Isso é calculado como a soma dos tamanhos de todos os contêineres no log.

CurrentAvailable

A quantidade de espaço disponível no log para novos registros e alocações de reserva. Esse espaço é o espaço total disponível menos o espaço de compromisso de desfazer e o espaço usado para armazenar páginas de proprietário em um log multiplexado.

TotalReservation

A quantidade de espaço reservado no fluxo (ou log físico) para operações de desfazer.

BaseFileSize

O tamanho, em bytes, do arquivo de log base.

ContainerSize

O tamanho, em bytes, de um contêiner individual no log. Observe que todos os contêineres no log têm o mesmo tamanho.

TotalContainers

O número de contêineres no log.

FreeContainers

O número de contêineres no log que não estão ativos.

TotalClients

O número de fluxos que compartilham o log.

Attributes

Um conjunto de sinalizadores que especificam atributos de fluxo (ou log físico). Consulte o parâmetro fFlagsAndAttributes da função ClfsCreateLogFile .

FlushThreshold

O número de bytes de dados (incluindo cabeçalhos) que têm permissão para permanecer pendentes na fila de liberação interna antes que o CLFS agende automaticamente um thread para gravar a fila de liberação no armazenamento estável.

SectorSize

O tamanho do setor, em bytes, da geometria de disco subjacente. O tamanho do setor é considerado um múltiplo de 512 e consistente entre contêineres.

MinArchiveTailLsn

O LSN do registro mais antigo no log para o qual o arquivamento não ocorreu. O mínimo disso e o LSN base determinam o último contêiner que pode ser reutilizado quando os contêineres são reciclados.

BaseLsn

O LSN do registro mais antigo no fluxo (ou log físico) que ainda é necessário para os clientes de fluxo (ou log).

LastFlushedLsn

O LSN do último registro que foi liberado para o armazenamento estável.

LastLsn

O LSN do registro mais jovem no fluxo (ou log físico) que ainda é necessário para os clientes de fluxo (ou log).

RestartLsn

O LSN do último registro de reinicialização gravado no fluxo (ou log físico). Se não houver registros de reinicialização, esse membro será igual a CLFS_LSN_INVALID.

Identity

Um GUID que serve como um identificador exclusivo para o log.

Comentários

A função ClfsQueryLogFileInformation retorna informações sobre um fluxo CLFS e/ou seu log físico subjacente. O tipo de informação retornada depende do parâmetro eInformationClass .

Se o parâmetro eInformationClass for igual a ClfsLogBasicInformationPhysical, ClfsQueryLogFileInformation retornará informações em uma estrutura CLFS_INFORMATION e cada membro da estrutura conterá uma informação sobre um log CLFS físico. Mesmo que o log seja multiplexado (ou seja, ele tem vários fluxos), todos os membros da estrutura contêm informações sobre o log físico subjacente em vez de informações sobre um dos fluxos.

Se o parâmetro eInformationClass for igual a ClfsLogBasicInformation, ClfsQueryLogFileInformation retornará informações em uma estrutura CLFS_INFORMATION . A maioria dos membros da estrutura contém informações sobre um log físico CLFS, mas se o log for multiplexado, determinados membros conterão informações específicas de um fluxo específico. Os seguintes membros da estrutura contêm informações específicas para um fluxo em vez do log físico subjacente:

• TotalUndoCommitment
• Atributos
• BaseLsn
• LastLsn
• RestartLsn

Requisitos

Confira também

ClfsCreateLogFile

ClfsQueryLogFileInformation

ClfsSetLogFileInformation