CLS_INFORMATION-Struktur (wdm.h)

Die CLFS_INFORMATION-Struktur enthält Metadaten und Zustandsinformationen für einen CLFS-Stream (Common Log File System) und/oder dessen zugrunde liegendes physisches Protokoll.

Syntax

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;

Member

TotalAvailable

Der dem Protokoll zugeordnete gesamt verfügbare Speicherplatz. Dies wird als Summe der Größen aller Container im Protokoll berechnet.

CurrentAvailable

Der im Protokoll verfügbare Speicherplatz für neue Datensätze und Reservierungszuordnungen. Dieser Speicherplatz ist der gesamte verfügbare Speicherplatz abzüglich des Rückgängig-Verpflichtungsbereichs und des Speicherplatzes, der zum Speichern von Besitzerseiten in einem multiplexierten Protokoll verwendet wird.

TotalReservation

Der reservierte Speicherplatz im Stream (oder physischen Protokoll) für Rückgängig-Vorgänge.

BaseFileSize

Die Größe der Basisprotokolldatei in Bytes.

ContainerSize

Die Größe eines einzelnen Containers im Protokoll in Bytes. Beachten Sie, dass alle Container im Protokoll dieselbe Größe haben.

TotalContainers

Die Anzahl der Container im Protokoll.

FreeContainers

Die Anzahl der Container im Protokoll, die nicht aktiv sind.

TotalClients

Die Anzahl der Streams, die das Protokoll gemeinsam nutzen.

Attributes

Ein Satz von Flags, die Streamattribute (oder physisches Protokoll) angeben. Siehe den fFlagsAndAttributes-Parameter der ClfsCreateLogFile-Funktion .

FlushThreshold

Die Anzahl der Byte von Daten (einschließlich Headern), die in der internen Leerungswarteschlange ausstehend bleiben dürfen, bevor CLFS automatisch einen Thread plant, um die Leerungswarteschlange in stabilen Speicher zu schreiben.

SectorSize

Die Sektorgröße der zugrunde liegenden Datenträgergeometrie in Bytes. Es wird davon ausgegangen, dass die Sektorgröße ein Vielfaches von 512 und containerübergreifend konsistent ist.

MinArchiveTailLsn

Die LSN des ältesten Datensatzes im Protokoll, für den keine Archivierung stattgefunden hat. Das Minimum davon und die Basis-LSN bestimmt den letzten Container, der wiederverwendet werden kann, wenn Container wiederverwendet werden.

BaseLsn

Die LSN des ältesten Datensatzes im Stream (oder physischen Protokoll), der noch von den Streamclients (oder Protokollclients) benötigt wird.

LastFlushedLsn

Die LSN des letzten Datensatzes, der in stabilen Speicher geleert wurde.

LastLsn

Die LSN des jüngsten Datensatzes im Stream (oder physischen Protokoll), der noch von den Streamclients (oder Protokollclients) benötigt wird.

RestartLsn

Die LSN des letzten Neustartdatensatzes, der in den Stream (oder das physische Protokoll) geschrieben wurde. Wenn keine Neustartdatensätze vorhanden sind, ist dieser Member gleich CLFS_LSN_INVALID.

Identity

Eine GUID, die als eindeutiger Bezeichner für das Protokoll dient.

Hinweise

Die ClfsQueryLogFileInformation-Funktion gibt Informationen zu einem CLFS-Stream und/oder seinem zugrunde liegenden physischen Protokoll zurück. Der Typ der zurückgegebenen Informationen hängt vom eInformationClass-Parameter ab.

Wenn der eInformationClass-Parameter gleich ClfsLogBasicInformationPhysical ist, gibt ClfsQueryLogFileInformation Informationen in einer CLFS_INFORMATION-Struktur zurück, und jedes Strukturelement enthält informationen zu einem physischen CLFS-Protokoll. Selbst wenn das Protokoll multiplext ist (d. h., es enthält mehrere Streams), enthalten alle Strukturmember Informationen zum zugrunde liegenden physischen Protokoll und nicht Informationen zu einem der Streams.

Wenn der eInformationClass-Parameter gleich ClfsLogBasicInformation ist, gibt ClfsQueryLogFileInformation Informationen in einer CLFS_INFORMATION-Struktur zurück. Die meisten Strukturmember enthalten Informationen zu einem physischen CLFS-Protokoll, aber wenn das Protokoll multiplext ist, enthalten bestimmte Member Informationen, die für einen bestimmten Datenstrom spezifisch sind. Die folgenden Strukturmember enthalten Informationen, die für einen Datenstrom und nicht für das zugrunde liegende physische Protokoll spezifisch sind:

• TotalUndoCommitment
• Attribute
• BaseLsn
• LastLsn
• RestartLsn

Anforderungen

Anforderung	Wert
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

ClfsCreateLogFile

ClfsQueryLogFileInformation

ClfsSetLogFileInformation