TRACE_LOGFILE_HEADER struttura (evntrace.h)
La struttura TRACE_LOGFILE_HEADER contiene informazioni su una sessione di traccia eventi e sui relativi eventi. È il formato dati non elaborato dei dati di traccia nell'intestazione di un file di log ETW. È anche una parte delle informazioni restituite da OpenTrace e fornite al BufferCallback durante l'elaborazione della traccia.
Sintassi
typedef struct _TRACE_LOGFILE_HEADER {
ULONG BufferSize;
union {
ULONG Version;
struct {
UCHAR MajorVersion;
UCHAR MinorVersion;
UCHAR SubVersion;
UCHAR SubMinorVersion;
} VersionDetail;
} DUMMYUNIONNAME;
ULONG ProviderVersion;
ULONG NumberOfProcessors;
LARGE_INTEGER EndTime;
ULONG TimerResolution;
ULONG MaximumFileSize;
ULONG LogFileMode;
ULONG BuffersWritten;
union {
GUID LogInstanceGuid;
struct {
ULONG StartBuffers;
ULONG PointerSize;
ULONG EventsLost;
ULONG CpuSpeedInMHz;
} DUMMYSTRUCTNAME;
} DUMMYUNIONNAME2;
#if ...
PWCHAR LoggerName;
#if ...
PWCHAR LogFileName;
#if ...
RTL_TIME_ZONE_INFORMATION TimeZone;
#else
LPWSTR LoggerName;
#endif
#else
LPWSTR LogFileName;
#endif
#else
TIME_ZONE_INFORMATION TimeZone;
#endif
LARGE_INTEGER BootTime;
LARGE_INTEGER PerfFreq;
LARGE_INTEGER StartTime;
ULONG ReservedFlags;
ULONG BuffersLost;
} TRACE_LOGFILE_HEADER, *PTRACE_LOGFILE_HEADER;
Members
BufferSize
Dimensioni dei buffer della sessione di traccia eventi, in byte.
DUMMYUNIONNAME
DUMMYUNIONNAME.Version
Numero di versione del sistema operativo in cui è stata raccolta la traccia. Si tratta di un roll-up dei membri di VersionDetail. A partire dai byte a basso ordine, i primi due byte contengono MajorVersion, i due byte successivi contengono MinorVersion, i due byte successivi contengono SubVersion e gli ultimi due byte contengono SubMinorVersion.
DUMMYUNIONNAME.VersionDetail
DUMMYUNIONNAME.VersionDetail.MajorVersion
Numero di versione principale del sistema operativo in cui è stata raccolta la traccia.
DUMMYUNIONNAME.VersionDetail.MinorVersion
Numero di versione secondaria del sistema operativo in cui è stata raccolta la traccia.
DUMMYUNIONNAME.VersionDetail.SubVersion
Riservato.
DUMMYUNIONNAME.VersionDetail.SubMinorVersion
Riservato.
ProviderVersion
Numero di compilazione del sistema operativo in cui è stata raccolta la traccia.
NumberOfProcessors
Numero di processori nel sistema in cui è stata raccolta la traccia.
EndTime
Ora in cui la sessione di traccia degli eventi è stata arrestata, in intervalli di 100 nanosecondi da mezzanotte, 1° gennaio 1601. Questo valore può essere 0 se si utilizzano eventi in tempo reale o da un file di log che non è stato finalizzato (ad esempio, non è stato chiuso correttamente).
TimerResolution
Risoluzione del timer hardware, in unità di 100 nanosecondi. Per l'utilizzo, vedere Le osservazioni per EVENT_TRACE_HEADER.
MaximumFileSize
Dimensioni massime del file di log, in megabyte.
LogFileMode
Modalità di registrazione per la sessione di traccia eventi. Per un elenco di valori, vedere Costanti della modalità di registrazione.
BuffersWritten
Numero totale di buffer scritti dalla sessione di traccia eventi.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.LogInstanceGuid
Riservato.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.StartBuffers
Riservato.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.PointerSize
Dimensioni predefinite di un tipo di dati puntatore, in byte.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.EventsLost
Numero di eventi persi durante la sessione di traccia eventi. Gli eventi vengono principalmente persi a causa di memoria insufficiente allocata a una sessione di registrazione di traccia o a una frequenza molto elevata di eventi in ingresso.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.CpuSpeedInMHz
Velocità della CPU, in megahertz, del sistema in cui è stata raccolta la traccia.
Windows 2000: Questo membro non è supportato.
LoggerName
Non usare questo campo.
Il nome della sessione di traccia eventi è la prima stringa con terminazione null seguendo questa struttura in memoria.
LogFileName
Non usare questo campo.
Il nome del file di log di traccia eventi è la seconda stringa con terminazione null seguendo questa struttura in memoria. La prima stringa è il nome della sessione.
TimeZone
Struttura TIME_ZONE_INFORMATION che contiene il fuso orario per i membri BootTime, EndTime e StartTime.
BootTime
Ora in cui è stato avviato il sistema, in 100-nanosecondi intervalli da mezzanotte, 1 gennaio 1601. BootTime è supportato solo per le tracce scritte nella sessione Global Logger.
PerfFreq
Frequenza del contatore delle prestazioni ad alta risoluzione, se presente.
StartTime
Ora in cui è iniziata la sessione di traccia eventi, in intervalli da 100 nanosecondi dalla mezzanotte, 1 gennaio 1601.
ReservedFlags
Specifica il tipo di orologio. Per informazioni dettagliate, vedere il membro ClientContext di WNODE_HEADER.
BuffersLost
Numero totale di buffer persi durante la sessione di traccia degli eventi.
Commenti
Assicurarsi di inizializzare la memoria per questa struttura su zero prima di impostare i membri.
Il primo evento da qualsiasi file di log contiene i dati definiti in questa struttura. È possibile usare questa struttura per accedere ai dati dell'evento oppure è possibile usare la classe MOF EventTrace_Header per decodificare i dati dell'evento. L'uso di questa struttura per leggere i dati dell'evento potrebbe restituire risultati imprevisti se il consumer si trova in un computer diverso da quello che ha generato il file di log o il file di log è stato scritto in una sessione WOW (a 32 bit) in un computer a 64 bit. Ciò avviee perché i membri LoggerName e LogFileName sono puntatori e possono variare in base alla dimensione del membro PointerSize .
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | evntrace.h |