Compartilhar via


estrutura EVENT_INSTANCE_HEADER (evntrace.h)

A estrutura EVENT_INSTANCE_HEADER contém informações de rastreamento de eventos padrão comuns a todos os eventos gravados por TraceEventInstance. A estrutura também contém identificadores de registro para a classe de rastreamento de evento e o evento pai relacionado, que você usa para rastrear instâncias de uma transação ou relações hierárquicas entre eventos relacionados.

Sintaxe

typedef struct _EVENT_INSTANCE_HEADER {
  USHORT        Size;
  union {
    USHORT FieldTypeFlags;
    struct {
      UCHAR HeaderType;
      UCHAR MarkerFlags;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  union {
    ULONG Version;
    struct {
      UCHAR  Type;
      UCHAR  Level;
      USHORT Version;
    } Class;
  } DUMMYUNIONNAME2;
  ULONG         ThreadId;
  ULONG         ProcessId;
  LARGE_INTEGER TimeStamp;
  ULONGLONG     RegHandle;
  ULONG         InstanceId;
  ULONG         ParentInstanceId;
  union {
    struct {
      ULONG KernelTime;
      ULONG UserTime;
    } DUMMYSTRUCTNAME;
    ULONG64 ProcessorTime;
    struct {
      ULONG EventId;
      ULONG Flags;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME3;
  ULONGLONG     ParentRegHandle;
} EVENT_INSTANCE_HEADER, *PEVENT_INSTANCE_HEADER;

Membros

Size

Número total de bytes do evento. O tamanho deve incluir o tamanho da estrutura EVENT_INSTANCE_HEADER , além do tamanho de todos os dados específicos do evento acrescentados a essa estrutura. O tamanho deve ser menor que o tamanho do buffer da sessão de rastreamento de eventos menos 72 (0x48).

DUMMYUNIONNAME

Uma união de várias estruturas e membros.

DUMMYUNIONNAME.FieldTypeFlags

Reservado.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

Reservado.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.HeaderType

Reservado.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MarkerFlags

Reservado.

DUMMYUNIONNAME2

Uma união de Classe em duas formas.

DUMMYUNIONNAME2.Version

Este é um roll-up dos membros da Classe. O byte de baixa ordem contém o Tipo, o próximo byte contém o Nível e os dois últimos bytes contêm a versão.

DUMMYUNIONNAME2.Class

A estrutura De classe.

DUMMYUNIONNAME2.Class.Type

Tipo de evento. Um provedor pode definir seus próprios tipos de evento ou usar os tipos de evento predefinidos listados na tabela a seguir.

  • EVENT_TRACE_TYPE_CHECKPOINT

    Evento checkpoint. Use para um evento que não esteja no início ou no final de uma atividade.

  • EVENT_TRACE_TYPE_DC_END

    Evento final da coleta de dados.

  • EVENT_TRACE_TYPE_DC_START

    Evento de início da coleta de dados.

  • EVENT_TRACE_TYPE_DEQUEUE

    Evento de remoção de fila. Use quando uma atividade for enfileirada antes de começar. Use EVENT_TRACE_TYPE_START para marcar a hora em que um item de trabalho está na fila. Use o tipo de evento de remoção de fila para marcar a hora em que o trabalho no item realmente começa. Use EVENT_TRACE_TYPE_END para marcar a hora em que o trabalho no item é concluído.

  • EVENT_TRACE_TYPE_END

    Evento final. Use para rastrear o estado final de um evento de várias etapas.

  • EVENT_TRACE_TYPE_EXTENSION

    Evento de extensão. Use para um evento que é uma continuação de um evento anterior. Por exemplo, use o tipo de evento de extensão quando um rastreamento de evento registrar mais dados do que pode caber em um buffer de sessão.

  • EVENT_TRACE_TYPE_INFO

    Evento informativo. Esse é o tipo de evento padrão.

  • EVENT_TRACE_TYPE_REPLY

    Evento de resposta. Use quando um aplicativo que solicita recursos puder receber várias respostas. Por exemplo, se um aplicativo cliente solicitar uma URL e o servidor Web responder enviando vários arquivos, cada arquivo recebido poderá ser marcado como um evento de resposta.

  • EVENT_TRACE_TYPE_START

    Evento De início. Use para rastrear o estado inicial de um evento de várias etapas.

Se o GUID da classe de rastreamento de eventos der suporte a vários tipos de evento, os consumidores usarão o tipo de evento para determinar o evento e como interpretar seu conteúdo.

DUMMYUNIONNAME2.Class.Level

Valor definido pelo provedor que define o nível de severidade usado para gerar o evento. O valor varia de 0 a 255. O controlador especifica o nível de severidade quando chama a função EnableTraceEx2 . O provedor recupera o nível de severidade chamando a função GetTraceEnableLevel de sua implementação ControlCallback . O provedor usa o valor para definir esse membro.

O ETW define os níveis de severidade a seguir. Selecionar um nível superior a 1 também incluirá eventos para níveis mais baixos. Por exemplo, se o controlador especificar TRACE_LEVEL_WARNING (3), o provedor também gerará eventos de TRACE_LEVEL_FATAL (1) e TRACE_LEVEL_ERROR (2).

Valor Significado
TRACE_LEVEL_CRITICAL (1) Eventos anormais de saída ou encerramento
TRACE_LEVEL_ERROR (2) Eventos de erro graves
TRACE_LEVEL_WARNING (3) Eventos de aviso, como falhas de alocação
TRACE_LEVEL_INFORMATION (4) Eventos sem erro, como eventos de entrada ou saída
TRACE_LEVEL_VERBOSE (5) Eventos de rastreamento detalhados

DUMMYUNIONNAME2.Class.Version

Indica a versão da classe de rastreamento de evento que você está usando para registrar o evento em log. Especifique zero se houver apenas uma versão da classe de rastreamento de evento. A versão informa ao consumidor qual classe MOF usar para decifrar os dados do evento.

ThreadId

Na saída, identifica o thread que gerou o evento.

Observe que, no Windows 2000, ThreadId era um valor ULONGLONG .

ProcessId

Na saída, identifica o processo que gerou o evento.

Windows 2000: Não há suporte para esse membro.

TimeStamp

Na saída, contém a hora em que o evento ocorreu, em intervalos de 100 nanossegundos desde a meia-noite de 1º de janeiro de 1601.

RegHandle

Identificador para uma classe de rastreamento de evento registrada. Defina essa propriedade antes de chamar a função TraceEventInstance .

A função RegisterTraceGuids cria esse identificador (consulte o parâmetro TraceGuidReg ).

InstanceId

Na saída, contém o identificador de instância de rastreamento de evento associado a RegHandle.

ParentInstanceId

Na saída, contém o identificador de instância de rastreamento de evento associado a ParentRegHandle.

DUMMYUNIONNAME3

Uma união de structs e membros.

DUMMYUNIONNAME3.DUMMYSTRUCTNAME

Uma estrutura que contém os membros a seguir.

DUMMYUNIONNAME3.DUMMYSTRUCTNAME.KernelTime

Tempo de execução decorrido para instruções de modo kernel, em tiques de CPU. Se você estiver usando uma sessão privada, use o valor no membro ProcessorTime .

DUMMYUNIONNAME3.DUMMYSTRUCTNAME.UserTime

Tempo de execução decorrido para instruções de modo de usuário, em tiques de CPU. Se você estiver usando uma sessão privada, use o valor no membro ProcessorTime .

DUMMYUNIONNAME3.ProcessorTime

Para sessões privadas, o tempo de execução decorrido para instruções de modo de usuário, em tiques de CPU.

DUMMYUNIONNAME3.DUMMYSTRUCTNAME2

Uma união de structs e membros.

DUMMYUNIONNAME3.DUMMYSTRUCTNAME2.EventId

O identificador de evento.

DUMMYUNIONNAME3.DUMMYSTRUCTNAME2.Flags

Deve conter WNODE_FLAG_TRACED_GUID e também pode conter qualquer combinação do seguinte.

  • WNODE_FLAG_USE_GUID_PTR

    Especifique se o membro GuidPtr contém o GUID da classe.

  • WNODE_FLAG_USE_MOF_PTR

    Especifique se uma matriz de estruturas MOF_FIELD contém os dados de evento acrescentados a essa estrutura. O número de elementos na matriz é limitado a MAX_MOF_FIELDS.

ParentRegHandle

Manipule para uma classe de rastreamento de evento registrada de um evento pai. Defina essa propriedade antes de chamar a função TraceEventInstance se quiser rastrear uma relação hierárquica (elemento pai/elemento filho) entre eventos relacionados.

A função RegisterTraceGuids cria esse identificador (consulte o parâmetro TraceGuidReg ).

Comentários

Certifique-se de inicializar a memória dessa estrutura como zero antes de definir qualquer membro.

Requisitos

Requisito Valor
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

TraceEventInstance