struktur EVENT_DESCRIPTOR (relogger.h)
Struktur EVENT_DESCRIPTOR berisi metadata yang menentukan peristiwa.
Sintaks
typedef struct _EVENT_DESCRIPTOR {
USHORT Id;
UCHAR Version;
UCHAR Channel;
UCHAR Level;
UCHAR Opcode;
USHORT Task;
ULONGLONG Keyword;
} EVENT_DESCRIPTOR, *PEVENT_DESCRIPTOR;
Anggota
Id
Pengidentifikasi peristiwa.
Version
Versi peristiwa. Versi menunjukkan revisi ke definisi peristiwa. Anda dapat menggunakan anggota ini dan anggota Id untuk mengidentifikasi peristiwa secara unik dalam cakupan penyedia.
Channel
Audiens untuk acara (misalnya, administrator atau pengembang).
Level
Tingkat keparahan atau tingkat detail yang disertakan dalam peristiwa (misalnya, informasi atau fatal).
Opcode
Langkah dalam urutan operasi yang dilakukan dalam Tugas.
Task
Unit kerja yang lebih besar dalam aplikasi atau komponen (lebih luas dari Opcode).
Keyword
Bitmask yang menentukan grup logis peristiwa terkait. Setiap bit sesuai dengan satu grup. Peristiwa mungkin termasuk dalam satu atau beberapa grup. Kata kunci dapat berisi satu atau beberapa kata kunci yang ditentukan penyedia, kata kunci standar, atau keduanya.
Keterangan
Struktur ini mewakili peristiwa yang ditentukan dalam manifes. Anda tidak mendeklarasikan dan mengisi struktur ini, sebagai gantinya Anda menggunakan Pengkompilasi Pesan (MC.exe) untuk menghasilkan file header yang mendeklarasikan dan mengisi struktur ini untuk setiap peristiwa dalam manifes. Untuk detail tentang menulis manifes dan membuat file header, lihat Menulis Manifes Instrumentasi dan Mengkompilasi Manifes Instrumentasi.
Untuk detail tentang anggota struktur ini, lihat atribut jenis kompleks EventDefinitionType .
Anda menentukan struktur ini saat memanggil EventWrite atau EventWriteTransfer untuk menulis peristiwa. Anda juga dapat menggunakannya saat memanggil EventEnabled untuk menentukan apakah Anda harus menulis peristiwa.
Struktur ini juga disertakan dalam struktur EVENT_HEADER yang dikembalikan dengan rekaman peristiwa saat Anda menggunakan peristiwa menggunakan panggilan balik EventRecordCallback . Untuk peristiwa yang ditentukan MOF, anggota Opcode berisi nilai jenis peristiwa. Anggota Versi dan Tingkat berisi informasi yang diharapkan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | relogger.h (termasuk Evntprov.h) |