Compartilhar via


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

Confira também

EVENT_TRACE_LOGFILE

LARGE_INTEGER

TIME_ZONE_INFORMATION