estrutura TRACE_LOGFILE_HEADER (evntrace.h)
A estrutura TRACE_LOGFILE_HEADER contém informações sobre uma sessão de rastreamento de eventos e seus eventos. É o formato de dados brutos dos dados de informações de rastreamento no cabeçalho de um arquivo de log ETW. Também faz parte das informações retornadas pelo OpenTrace e fornecidas ao BufferCallback durante o processamento do rastreamento.
Sintaxe
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;
Membros
BufferSize
Tamanho dos buffers da sessão de rastreamento de eventos, em bytes.
DUMMYUNIONNAME
DUMMYUNIONNAME.Version
Número de versão do sistema operacional em que o rastreamento foi coletado. Este é um roll-up dos membros de VersionDetail. Começando com os bytes de baixa ordem, os dois primeiros bytes contêm MajorVersion, os dois próximos bytes contêm MinorVersion, os dois próximos bytes contêm SubVersion e os dois últimos bytes contêm SubMinorVersion.
DUMMYUNIONNAME.VersionDetail
DUMMYUNIONNAME.VersionDetail.MajorVersion
Número de versão principal do sistema operacional em que o rastreamento foi coletado.
DUMMYUNIONNAME.VersionDetail.MinorVersion
Número de versão secundária do sistema operacional em que o rastreamento foi coletado.
DUMMYUNIONNAME.VersionDetail.SubVersion
Reservado.
DUMMYUNIONNAME.VersionDetail.SubMinorVersion
Reservado.
ProviderVersion
Número de build do sistema operacional em que o rastreamento foi coletado.
NumberOfProcessors
Número de processadores no sistema em que o rastreamento foi coletado.
EndTime
Hora em que a sessão de rastreamento de eventos parou, em intervalos de 100 nanossegundos desde a meia-noite de 1º de janeiro de 1601. Esse valor poderá ser 0 se você estiver consumindo eventos em tempo real ou de um arquivo de log que não foi finalizado (ou seja, não foi fechado corretamente).
TimerResolution
Resolução do temporizador de hardware, em unidades de 100 nanossegundos. Para uso, consulte os Comentários para EVENT_TRACE_HEADER.
MaximumFileSize
Tamanho máximo do arquivo de log, em megabytes.
LogFileMode
Modo de registro em log para a sessão de rastreamento de eventos. Para obter uma lista de valores, consulte Constantes de modo de registro em log.
BuffersWritten
Número total de buffers gravados pela sessão de rastreamento de eventos.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.LogInstanceGuid
Reservado.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.StartBuffers
Reservado.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.PointerSize
Tamanho padrão de um tipo de dados de ponteiro, em bytes.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.EventsLost
Número de eventos perdidos durante a sessão de rastreamento de eventos. Os eventos são perdidos principalmente devido à memória insuficiente alocada a uma sessão de log de rastreamento ou a uma taxa muito alta de eventos de entrada.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.CpuSpeedInMHz
Velocidade da CPU, em megahertz, do sistema em que o rastreamento foi coletado.
Windows 2000: Não há suporte para esse membro.
LoggerName
Não use este campo.
O nome da sessão de rastreamento de eventos é a primeira cadeia de caracteres terminada em nulo após essa estrutura na memória.
LogFileName
Não use este campo.
O nome do arquivo de log de rastreamento de eventos é a segunda cadeia de caracteres terminada em nulo após essa estrutura na memória. A primeira cadeia de caracteres é o nome da sessão.
TimeZone
Uma estrutura TIME_ZONE_INFORMATION que contém o fuso horário para os membros BootTime, EndTime e StartTime .
BootTime
Hora em que o sistema foi iniciado, em intervalos de 100 nanossegundos desde a meia-noite de 1º de janeiro de 1601. O BootTime tem suporte apenas para rastreamentos gravados na sessão do Agente Global.
PerfFreq
Frequência do contador de desempenho de alta resolução, se houver.
StartTime
Hora em que a sessão de rastreamento de eventos foi iniciada, em intervalos de 100 nanossegundos desde a meia-noite de 1º de janeiro de 1601.
ReservedFlags
Especifica o tipo de relógio. Para obter detalhes, consulte o membro ClientContext do WNODE_HEADER.
BuffersLost
Número total de buffers perdidos durante a sessão de rastreamento de eventos.
Comentários
Certifique-se de inicializar a memória dessa estrutura como zero antes de definir qualquer membro.
O primeiro evento de qualquer arquivo de log contém os dados definidos nessa estrutura. Você pode usar essa estrutura para acessar os dados do evento ou pode usar o EventTrace_Header classe MOF para decodificar os dados do evento. Usar essa estrutura para ler os dados do evento poderá retornar resultados inesperados se o consumidor estiver em um computador diferente daquele que gerou o arquivo de log ou se o arquivo de log tiver sido gravado em uma sessão WOW (32 bits) em um computador de 64 bits. Isso ocorre porque os membros LoggerName e LogFileName são ponteiros e podem variar de tamanho dependendo do membro PointerSize .
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | evntrace.h |