Condividi tramite


struttura EVENT_DESCRIPTOR (relogger.h)

La struttura EVENT_DESCRIPTOR contiene metadati che definiscono l'evento.

Sintassi

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

Members

Id

Identificatore dell'evento.

Version

Versione dell'evento. La versione indica una revisione della definizione dell'evento. È possibile usare questo membro e il membro ID per identificare in modo univoco l'evento nell'ambito di un provider.

Channel

Destinatari dell'evento , ad esempio amministratore o sviluppatore.

Level

Gravità o livello di dettaglio inclusi nell'evento (ad esempio, informativo o irreversibile).

Opcode

Passaggio in una sequenza di operazioni eseguite all'interno dell'attività.

Task

Un'unità di lavoro più grande all'interno di un'applicazione o di un componente (è più ampia di Opcode).

Keyword

Maschera di bit che specifica un gruppo logico di eventi correlati. Ogni bit corrisponde a un gruppo. Un evento può appartenere a uno o più gruppi. La parola chiave può contenere una o più parole chiave definite dal provider, parole chiave standard o entrambe.

Commenti

Questa struttura rappresenta un evento definito nel manifesto. Non si dichiara e si popola questa struttura, ma si usa il compilatore di messaggi (MC.exe) per generare un file di intestazione che dichiara e popola questa struttura per ogni evento nel manifesto. Per informazioni dettagliate sulla scrittura del manifesto e sulla generazione del file di intestazione, vedere Scrittura di un manifesto di strumentazione e compilazione di un manifesto di strumentazione.

Per informazioni dettagliate sui membri di questa struttura, vedere gli attributi del tipo complesso EventDefinitionType .

Questa struttura viene specificata quando si chiama EventWrite o EventWriteTransfer per scrivere l'evento. È anche possibile usarlo quando si chiama EventEnabled per determinare se è necessario scrivere l'evento.

Questa struttura è inclusa anche nella struttura EVENT_HEADER restituita con il record dell'evento quando si utilizzano gli eventi usando il callback EventRecordCallback . Per gli eventi definiti da MOF, il membro Opcode contiene il valore del tipo di evento. I membri Version e Level contengono le informazioni previste.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione relogger.h (include Evntprov.h)

Vedi anche

EVENT_HEADER

EventDescCreate

EventDescGetChannel

EventDescGetId

EventDescGetKeyword

EventDescGetLevel

EventDescGetOpcode

EventDescGetTask

EventDescGetVersion

EventDescOrKeyword

EventDescSetChannel

EventDescSetId

EventDescSetKeyword

EventDescSetLevel

EventDescSetOpcode

EventDescSetTask

EventDescSetVersion

EventDescZero

EventEnabled

EventWrite

EventWriteTransfer

PROVIDER_EVENT_INFO

TdhEnumerateManifestProviderEvents

TdhGetManifestEventInformation