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

Vedi anche

EVENT_TRACE_LOGFILE

LARGE_INTEGER

TIME_ZONE_INFORMATION