Compartir a través de


estructura TRACE_LOGFILE_HEADER (evntrace.h)

La estructura TRACE_LOGFILE_HEADER contiene información sobre una sesión de seguimiento de eventos y sus eventos. Es el formato de datos sin procesar de los datos de información de seguimiento en el encabezado de un archivo de registro ETW. También forma parte de la información devuelta por OpenTrace y se proporciona a BufferCallback durante el procesamiento de seguimiento.

Sintaxis

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;

Miembros

BufferSize

Tamaño de los búferes de la sesión de seguimiento de eventos, en bytes.

DUMMYUNIONNAME

DUMMYUNIONNAME.Version

Número de versión del sistema operativo donde se recopiló el seguimiento. Se trata de un resumen de los miembros de VersionDetail. A partir de los bytes de orden bajo, los dos primeros bytes contienen MajorVersion, los dos bytes siguientes contienen MinorVersion, los dos bytes siguientes contienen SubVersion y los dos últimos bytes contienen SubMinorVersion.

DUMMYUNIONNAME.VersionDetail

DUMMYUNIONNAME.VersionDetail.MajorVersion

Número de versión principal del sistema operativo donde se recopiló el seguimiento.

DUMMYUNIONNAME.VersionDetail.MinorVersion

Número de versión secundaria del sistema operativo donde se recopiló el seguimiento.

DUMMYUNIONNAME.VersionDetail.SubVersion

Reservado.

DUMMYUNIONNAME.VersionDetail.SubMinorVersion

Reservado.

ProviderVersion

Número de compilación del sistema operativo donde se recopiló el seguimiento.

NumberOfProcessors

Número de procesadores en el sistema donde se recopiló el seguimiento.

EndTime

Hora en la que se detuvo la sesión de seguimiento de eventos, en intervalos de 100 nanosegundos desde medianoche, 1 de enero de 1601. Este valor puede ser 0 si consume eventos en tiempo real o desde un archivo de registro que no se finalizó (es decir, no se cerró correctamente).

TimerResolution

Resolución del temporizador de hardware, en unidades de 100 nanosegundos. Para su uso, consulte los comentarios de EVENT_TRACE_HEADER.

MaximumFileSize

Tamaño máximo del archivo de registro, en megabytes.

LogFileMode

Modo de registro para la sesión de seguimiento de eventos. Para obtener una lista de valores, vea Constantes de modo de registro.

BuffersWritten

Número total de búferes escritos por la sesión de seguimiento de eventos.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.LogInstanceGuid

Reservado.

DUMMYUNIONNAME2.DUMMYSTRUCTNAME

DUMMYUNIONNAME2.DUMMYSTRUCTNAME.StartBuffers

Reservado.

DUMMYUNIONNAME2.DUMMYSTRUCTNAME.PointerSize

Tamaño predeterminado de un tipo de datos de puntero, en bytes.

DUMMYUNIONNAME2.DUMMYSTRUCTNAME.EventsLost

Número de eventos perdidos durante la sesión de seguimiento de eventos. Los eventos se pierden principalmente debido a una memoria insuficiente asignada a una sesión de registro de seguimiento o a una tasa muy alta de eventos entrantes.

DUMMYUNIONNAME2.DUMMYSTRUCTNAME.CpuSpeedInMHz

Velocidad de CPU, en megahercios, del sistema donde se recopiló el seguimiento.

Windows 2000: No se admite este miembro.

LoggerName

No use este campo.

El nombre de la sesión de seguimiento de eventos es la primera cadena terminada en null que sigue a esta estructura en memoria.

LogFileName

No use este campo.

El nombre del archivo de registro de seguimiento de eventos es la segunda cadena terminada en null que sigue a esta estructura en memoria. La primera cadena es el nombre de la sesión.

TimeZone

Estructura TIME_ZONE_INFORMATION que contiene la zona horaria de los miembros BootTime, EndTime e StartTime.

BootTime

Hora a la que se inició el sistema, en intervalos de 100 nanosegundos desde medianoche, 1 de enero de 1601. BootTime solo se admite para seguimientos escritos en la sesión del registrador global.

PerfFreq

Frecuencia del contador de rendimiento de alta resolución, si existe uno.

StartTime

Hora en la que se inició la sesión de seguimiento de eventos, en intervalos de 100 nanosegundos desde medianoche, 1 de enero de 1601.

ReservedFlags

Especifica el tipo de reloj. Para obtener más información, consulte el miembro ClientContext de WNODE_HEADER.

BuffersLost

Número total de búferes perdidos durante la sesión de seguimiento de eventos.

Comentarios

Asegúrese de inicializar la memoria de esta estructura en cero antes de establecer los miembros.

El primer evento de cualquier archivo de registro contiene los datos definidos en esta estructura. Puede usar esta estructura para acceder a los datos del evento o puede usar la EventTrace_Header clase MOF para descodificar los datos del evento. El uso de esta estructura para leer los datos del evento puede devolver resultados inesperados si el consumidor está en un equipo diferente del que generó el archivo de registro o el archivo de registro se escribió en una sesión WOW (de 32 bits) en un equipo de 64 bits. Esto se debe a que los miembros LoggerName y LogFileName son punteros y pueden variar en tamaño según el miembro PointerSize .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado evntrace.h

Consulte también

EVENT_TRACE_LOGFILE

LARGE_INTEGER

TIME_ZONE_INFORMATION