EVENT_DESCRIPTOR estructura (relogger.h)

Artículo
03/05/2024

La estructura EVENT_DESCRIPTOR contiene metadatos que definen el evento.

Sintaxis

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

Miembros

Id

Identificador de evento.

Version

Versión del evento. La versión indica una revisión a la definición del evento. Puede usar este miembro y el miembro Id para identificar de forma única el evento dentro del ámbito de un proveedor.

Channel

Audiencia del evento (por ejemplo, administrador o desarrollador).

Level

Gravedad o nivel de detalle incluido en el evento (por ejemplo, informativo o irrecuperable).

Opcode

Un paso en una secuencia de operaciones que se realizan dentro de la tarea.

Task

Una unidad de trabajo mayor dentro de una aplicación o componente (es más amplia que opcode).

Keyword

Máscara de bits que especifica un grupo lógico de eventos relacionados. Cada bit corresponde a un grupo. Un evento puede pertenecer a uno o varios grupos. La palabra clave puede contener una o más palabras clave definidas por el proveedor, palabras clave estándar o ambas.

Comentarios

Esta estructura representa un evento definido en el manifiesto. No declara y rellena esta estructura, en su lugar usa el compilador de mensajes (MC.exe) para generar un archivo de encabezado que declare y rellene esta estructura para cada evento del manifiesto. Para obtener más información sobre cómo escribir el manifiesto y generar el archivo de encabezado, consulte Escritura de un manifiesto de instrumentación y Compilación de un manifiesto de instrumentación.

Para obtener más información sobre los miembros de esta estructura, vea los atributos del tipo complejo EventDefinitionType .

Esta estructura se especifica al llamar a EventWrite o EventWriteTransfer para escribir el evento. También puede usarlo al llamar a EventEnabled para determinar si debe escribir el evento.

Esta estructura también se incluye en la estructura EVENT_HEADER que se devuelve con el registro de eventos cuando se consumen eventos mediante la devolución de llamada EventRecordCallback . En el caso de los eventos definidos por MOF, el miembro Opcode contiene el valor de tipo de evento. Los miembros Version y Level contienen la información esperada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	relogger.h (include Evntprov.h)