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) |