CLS_INFORMATION structure (wdm.h)

La structure CLFS_INFORMATION contient des métadonnées et des informations d’état pour un flux CLFS (Common Log File System) et/ou son journal physique sous-jacent.

Syntaxe

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;

Membres

TotalAvailable

Espace total disponible alloué au journal. Cette valeur est calculée comme la somme des tailles de tous les conteneurs dans le journal.

CurrentAvailable

Quantité d’espace disponible dans le journal pour les nouveaux enregistrements et les allocations de réservations. Cet espace est l’espace total disponible moins l’espace d’annulation d’engagement et l’espace utilisé pour stocker les pages propriétaire dans un journal multiplexé.

TotalReservation

Quantité d’espace réservé dans le flux (ou le journal physique) pour les opérations d’annulation.

BaseFileSize

Taille, en octets, du fichier journal de base.

ContainerSize

Taille, en octets, d’un conteneur individuel dans le journal. Notez que tous les conteneurs du journal ont la même taille.

TotalContainers

Nombre de conteneurs dans le journal.

FreeContainers

Nombre de conteneurs non actifs dans le journal.

TotalClients

Nombre de flux qui partagent le journal.

Attributes

Ensemble d’indicateurs qui spécifient des attributs de flux (ou de journal physique). Consultez le paramètre fFlagsAndAttributes de la fonction ClfsCreateLogFile .

FlushThreshold

Nombre d’octets de données (y compris les en-têtes) autorisés à rester en attente dans la file d’attente de vidage interne avant que CLFS planifie automatiquement un thread pour écrire la file d’attente de vidage dans un stockage stable.

SectorSize

Taille de secteur, en octets, de la géométrie de disque sous-jacente. La taille du secteur est supposée être un multiple de 512 et cohérente entre les conteneurs.

MinArchiveTailLsn

LSN du plus ancien enregistrement du journal pour lequel l’archivage n’a pas eu lieu. La valeur minimale de ce nom et le numéro LSN de base déterminent le dernier conteneur pouvant être réutilisé lorsque les conteneurs sont recyclés.

BaseLsn

LSN du plus ancien enregistrement dans le flux (ou journal physique) qui est toujours requis par les clients de flux (ou de journal).

LastFlushedLsn

LSN du dernier enregistrement qui a été vidé dans un stockage stable.

LastLsn

LSN du plus jeune enregistrement dans le flux (ou journal physique) qui est toujours nécessaire pour les clients de flux (ou de journal).

RestartLsn

LSN du dernier enregistrement de redémarrage écrit dans le flux (ou le journal physique). S’il n’y a pas d’enregistrements de redémarrage, ce membre est égal à CLFS_LSN_INVALID.

Identity

GUID qui sert d’identificateur unique pour le journal.

Remarques

La fonction ClfsQueryLogFileInformation retourne des informations sur un flux CLFS et/ou son journal physique sous-jacent. Le type d’informations retournées dépend du paramètre eInformationClass .

Si le paramètre eInformationClass est égal à ClfsLogBasicInformationPhysical, ClfsQueryLogFileInformation retourne des informations dans une structure CLFS_INFORMATION , et chaque membre de la structure contient des informations sur un journal CLFS physique. Même si le journal est multiplexé (c’est-à-dire qu’il comporte plusieurs flux), tous les membres de la structure contiennent des informations sur le journal physique sous-jacent plutôt que sur l’un des flux.

Si le paramètre eInformationClass est égal à ClfsLogBasicInformation, ClfsQueryLogFileInformation retourne des informations dans une structure CLFS_INFORMATION . La plupart des membres de la structure contiennent des informations sur un journal physique CLFS, mais si le journal est multiplexé, certains membres contiennent des informations spécifiques à un flux particulier. Les membres de structure suivants contiennent des informations spécifiques à un flux plutôt que le journal physique sous-jacent :

• TotalUndoCommitment
• Attributs
• BaseLsn
• LastLsn
• RestartLsn

Configuration requise

Voir aussi

ClfsCreateLogFile

ClfsQueryLogFileInformation

ClfsSetLogFileInformation