estrutura EVENT_DESCRIPTOR (relogger.h)
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) |