Bagikan melalui

enumerasi EVENT_INFO_CLASS (evntprov.h)

  • Artikel

Jenis enumerasi EVENT_INFO_CLASS digunakan dengan fungsi EventSetInformation untuk menentukan operasi konfigurasi yang akan dilakukan pada pendaftaran penyedia peristiwa ETW.

Sintaks

typedef enum _EVENT_INFO_CLASS {
  EventProviderBinaryTrackInfo,
  EventProviderSetReserved1,
  EventProviderSetTraits,
  EventProviderUseDescriptorType,
  MaxEventInfo
} EVENT_INFO_CLASS;

Konstanta

 
EventProviderBinaryTrackInfo
Menambahkan informasi pelacakan biner dari penyedia ini ke setiap sesi yang
mengumpulkan peristiwa dari penyedia kejadian ini. Data pelacakan biner mencakup
jalur lengkap ke biner yang berisi panggilan balik yang ditentukan ketika
mendaftarkan penyedia peristiwa. Informasi ini berguna jika biner
berisi mc.exe-generated
mendekode sumber daya tetapi tidak terdaftar secara global. Alat pendekodean dapat menggunakan
jalur dalam jejak untuk menemukan biner dan mengekstrak sumber daya decoding.

Buffer EventInformation tidak digunakan dengan operasi konfigurasi ini. The
Runtime ETW akan secara otomatis menggunakan jalur lengkap modul pemanggil (
jalur lengkap ke DLL atau EXE yang berisi fungsi panggilan balik yang ditentukan dalam
panggilan ke EventRegister). Agar operasi ini berguna, DLL atau EXE yang sama
file harus berisi mc.exesumber daya decoding -generated.
EventProviderSetReserved1
Tidak digunakan.
EventProviderSetTraits
Mengatur sifat untuk penyedia seperti nama penyedia. Menunjukkan bahwa ETW
harus mengenali Type bidang
EVENT_DATA_DESCRIPTOR struktur yang digunakan
dengan penyedia ini. Mengharuskan penyedia untuk menginisialisasi semua bidang
EVENT_DATA_DESCRIPTOR struktur, termasuk Reserved bidang . (The
penyedia biasanya harus mengatur dataDescriptor.Reserved = 0, seperti yang dilakukan oleh
EventDataDescCreate.)

Perhatikan bahwa struktur EVENT_DATA_DESCRIPTOR berisi Type bidang dalam
bagian struktur yang sebelumnya Reserved merupakan bidang . Untuk menghindari
masalah kompatibilitas dengan penyedia yang membuat bidang Khusus tidak diinisialisasi,
ETW akan mengabaikan Type bidang (memperlakukannya sebagai 0) kecuali penyedia telah menggunakan
EventProviderSetTraits atau EventProviderUseDescriptorType dalam panggilan ke
EventSetInformation.

Buffer EventInformation harus berisi
ciri penyedia yang akan digunakan untuk
Penyedia.
EventProviderUseDescriptorType
Menentukan apakah ETW harus mengenali Type bidang
EVENT_DATA_DESCRIPTOR struktur yang digunakan
dengan penyedia ini. Jika TRUE, mengharuskan penyedia untuk menginisialisasi semua bidang
struktur EVENT_DATA_DESCRIPTOR , termasuk Reserved bidang . (The
penyedia biasanya harus mengatur dataDescriptor.Reserved = 0, seperti yang dilakukan oleh
EventDataDescCreate.)

Perhatikan bahwa struktur EVENT_DATA_DESCRIPTOR berisi Type bidang dalam
bagian struktur yang sebelumnya Reserved merupakan bidang . Untuk menghindari
masalah kompatibilitas dengan penyedia yang membuat bidang Khusus tidak diinisialisasi,
ETW akan mengabaikan Type bidang (memperlakukannya sebagai 0) kecuali penyedia telah menggunakan
EventProviderSetTraits atau EventProviderUseDescriptorType dalam panggilan ke
EventSetInformation.

Buffer EventInformation harus berisi nilai BOOLEAN (1 byte, nilai
FALSE atau TRUE).
MaxEventInfo
Kode operasi pertama yang tidak valid. Nilai ini dapat berubah dalam versi berikutnya
dari Windows SDK.

Persyaratan

   
Klien minimum yang didukung Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Header evntprov.h

Lihat juga

EventSetInformation

Sifat Penyedia