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 |