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).

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

Confira também

TraceEventInstance