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