estrutura EVENT_DESCRIPTOR (relogger.h)

Artigo
08/25/2023

A estrutura EVENT_DESCRIPTOR contém metadados que definem o evento.

Sintaxe

typedef struct _EVENT_DESCRIPTOR {
  USHORT    Id;
  UCHAR     Version;
  UCHAR     Channel;
  UCHAR     Level;
  UCHAR     Opcode;
  USHORT    Task;
  ULONGLONG Keyword;
} EVENT_DESCRIPTOR, *PEVENT_DESCRIPTOR;

Membros

Id

O identificador de evento.

Version

A versão do evento. A versão indica uma revisão para a definição do evento. Você pode usar esse membro e o membro Id para identificar exclusivamente o evento dentro do escopo de um provedor.

Channel

O público-alvo do evento (por exemplo, administrador ou desenvolvedor).

Level

A gravidade ou o nível de detalhes incluídos no evento (por exemplo, informativo ou fatal).

Opcode

Uma etapa em uma sequência de operações que estão sendo executadas dentro da Tarefa.

Task

Uma unidade de trabalho maior dentro de um aplicativo ou componente (é mais ampla que o Opcode).

Keyword

Uma máscara de bits que especifica um grupo lógico de eventos relacionados. Cada bit corresponde a um grupo. Um evento pode pertencer a um ou mais grupos. A palavra-chave pode conter um ou mais palavras-chave, palavras-chave padrão ou ambos definidos pelo provedor.

Comentários

Essa estrutura representa um evento definido no manifesto. Você não declara e preenche essa estrutura, em vez disso, usa o Compilador de Mensagens (MC.exe) para gerar um arquivo de cabeçalho que declara e preenche essa estrutura para cada evento no manifesto. Para obter detalhes sobre como gravar o manifesto e gerar o arquivo de cabeçalho, consulte Escrevendo um manifesto de instrumentação e Compilando um manifesto de instrumentação.

Para obter detalhes sobre os membros dessa estrutura, consulte os atributos do tipo complexo EventDefinitionType .

Especifique essa estrutura ao chamar EventWrite ou EventWriteTransfer para gravar o evento. Você também pode usá-lo ao chamar EventEnabled para determinar se deve gravar o evento.

Essa estrutura também está incluída na estrutura EVENT_HEADER retornada com o registro de evento quando você consome eventos usando o retorno de chamada EventRecordCallback . Para eventos definidos por MOF, o membro Opcode contém o valor do tipo de evento. Os membros Version e Level contêm as informações esperadas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	relogger.h (inclua Evntprov.h)