Bagikan melalui

enumerasi TRACE_QUERY_INFO_CLASS (evntrace.h)

  • Artikel

Digunakan dengan EnumerateTraceGuidsEx, TraceQueryInformation, atau TraceSetInformation untuk menentukan jenis informasi jejak.

Perhatikan bahwa TRACE_INFO_CLASS dan TRACE_QUERY_INFO_CLASS adalah typedefs untuk enumerasi yang sama.

Dokumentasi yang lebih komprehensif tentang API mana yang harus digunakan nilai dalam enumerasi, serta format input dan output buffer yang sesuai tersedia sejalan dalam TRACE_QUERY_INFO_CLASS definisi enumerasi di evntrace.h.

Sintaks

typedef enum _TRACE_QUERY_INFO_CLASS {
  TraceGuidQueryList = 0,
  TraceGuidQueryInfo = 1,
  TraceGuidQueryProcess = 2,
  TraceStackTracingInfo = 3,
  TraceSystemTraceEnableFlagsInfo = 4,
  TraceSampledProfileIntervalInfo = 5,
  TraceProfileSourceConfigInfo = 6,
  TraceProfileSourceListInfo = 7,
  TracePmcEventListInfo = 8,
  TracePmcCounterListInfo = 9,
  TraceSetDisallowList = 10,
  TraceVersionInfo = 11,
  TraceGroupQueryList = 12,
  TraceGroupQueryInfo = 13,
  TraceDisallowListQuery = 14,
  TraceInfoReserved15,
  TracePeriodicCaptureStateListInfo = 16,
  TracePeriodicCaptureStateInfo = 17,
  TraceProviderBinaryTracking = 18,
  TraceMaxLoggersQuery = 19,
  TraceLbrConfigurationInfo = 20,
  TraceLbrEventListInfo = 21,
  TraceMaxPmcCounterQuery = 22,
  TraceStreamCount = 23,
  TraceStackCachingInfo = 24,
  TracePmcCounterOwners = 25,
  TraceUnifiedStackCachingInfo = 26,
  TracePmcSessionInformation = 27,
  TraceContextRegisterInfo = 28,
  MaxTraceSetInfoClass = 29
} TRACE_QUERY_INFO_CLASS, TRACE_INFO_CLASS;

Konstanta

 
TraceGuidQueryList
Nilai: 0
Kueri untuk array GUID penyedia yang terdaftar di
Komputer.
TraceGuidQueryInfo
Nilai: 1
Kueri untuk informasi yang digunakan setiap sesi untuk mengaktifkan penyedia.
TraceGuidQueryProcess
Nilai: 2
Kueri untuk array GUID penyedia yang mendaftarkan diri mereka di
proses yang sama dengan proses panggilan.
TraceStackTracingInfo
Nilai: 3
Kueri pengaturan untuk pelacakan tumpukan panggilan untuk peristiwa kernel.

Mengembalikan array CLASSIC_EVENT_ID
Struktur. Struktur menentukan GUID peristiwa yang pelacakan tumpukannya
diaktifkan. Array dibatasi hingga 256 elemen.

Nilai ini didukung pada Windows 7, Windows Server 2008 R2, dan yang lebih baru.
TraceSystemTraceEnableFlagsInfo
Nilai: 4
Kueri pengaturan untuk EnableFlags untuk penyedia pelacakan sistem. Untuk
informasi selengkapnya, lihat
EVENT_TRACE_PROPERTIES struktur.

Nilai ini didukung pada Windows 8, Windows Server 2012, dan yang lebih baru.
TraceSampledProfileIntervalInfo
Nilai: 5
Mengkueri pengaturan untuk interval profil pengambilan sampel untuk sumber yang disediakan.

Nilai ini didukung pada Windows 8, Windows Server 2012, dan yang lebih baru.
TraceProfileSourceConfigInfo
Nilai: 6
Mengonfigurasi daftar sumber pembuatan profil yang akan dikumpulkan saat
peristiwa profil penghitung pemantauan performa diaktifkan. Penghitung yang dikumpulkan akan
dipancarkan sebagai bagian PERF_PMC_PROFILE dari peristiwa.

Nilai ini didukung pada Windows 8, Windows Server 2012, dan yang lebih baru.
TraceProfileSourceListInfo
Nilai: 7
Mengkueri daftar sumber pembuatan profil yang tersedia di sistem.

Nilai ini didukung pada Windows 8, Windows Server 2012, dan yang lebih baru.
TracePmcEventListInfo
Nilai: 8
Mengonfigurasi sesi dengan daftar peristiwa sistem yang performanya
penghitung pemantauan yang dikonfigurasi oleh TracePmcCounterListInfo akan dikumpulkan.

Nilai ini didukung pada Windows 8, Windows Server 2012, dan yang lebih baru.
TracePmcCounterListInfo
Nilai: 9
Mengonfigurasi sesi dengan daftar sumber pembuatan profil yang akan dikumpulkan
ketika peristiwa yang dikonfigurasi oleh TracePmcEventListInfo dicatat ke sesi.

Nilai ini didukung pada Windows 8, Windows Server 2012, dan yang lebih baru.
TraceSetDisallowList
Nilai: 10
Atur daftar penyedia yang tidak akan diaktifkan ke sesi ini sebagai bagian dari
pengaktifan grup penyedia. Untuk mengetahui informasi selengkapnya, lihat
Sifat Penyedia.

Nilai ini didukung pada Windows 10, Windows Server 2016, dan yang lebih baru.
TraceVersionInfo
Nilai: 11
Mengkueri informasi versi file pelacakan.

Nilai ini didukung pada Windows 10, Windows Server 2016, dan yang lebih baru.
TraceGroupQueryList
Nilai: 12
Mengkueri array GUID grup penyedia yang aktif di komputer.
TraceGroupQueryInfo
Nilai: 13
Nilai ini didukung pada Windows 10, Windows Server 2016, dan yang lebih baru.

Informasi kueri yang digunakan setiap sesi untuk mengaktifkan grup penyedia.
TraceDisallowListQuery
Nilai: 14
Nilai ini didukung pada Windows 10, Windows Server 2016, dan yang lebih baru.

Mengkueri array GUID yang tidak diizinkan untuk grup diaktifkan pada sesi ini.

Nilai ini didukung pada Windows 10, Windows Server 2016, dan yang lebih baru.
TraceInfoReserved15
Disiapkan untuk penggunaan masa mendatang. Jangan gunakan.
TracePeriodicCaptureStateListInfo
Nilai: 16
Memperbarui sesi dengan daftar penyedia yang akan secara berkala menerima
EVENT_CONTROL_CODE_CAPTURE_STATE kode kontrol, mirip dengan panggilan dari
EnableTraceEx2.

Untuk mengetahui informasi selengkapnya, lihat
TRACE_PERIODIC_CAPTURE_STATE_INFO.

Nilai ini didukung pada Windows 10, versi 1709, Windows Server, versi
1709, dan yang lebih baru.
TracePeriodicCaptureStateInfo
Nilai: 17
Mengkueri batas pengaturan status pengambilan berkala pada sistem, termasuk
frekuensi waktu minimum dan jumlah maksimum penyedia yang dapat
dikonfigurasi secara bersamaan.

Untuk mengetahui informasi selengkapnya, lihat
TRACE_PERIODIC_CAPTURE_STATE_INFO.

Nilai ini didukung pada Windows 10, versi 1709, Windows Server, versi
1709, dan yang lebih baru.
TraceProviderBinaryTracking
Nilai: 18
Menginstruksikan ETW untuk mulai melacak biner untuk semua penyedia yang diaktifkan untuk
sesi. Pelacakan berlaku untuk penyedia yang diaktifkan ke sesi
pada saat panggilan serta ke semua penyedia di masa mendatang yang diaktifkan untuk
sesi.

ETW menghasilkan peristiwa pelacakan yang berisi pemetaan antara GUID penyedia
dan jalur ke modul yang berisi panggilan balik untuk penyedia yang dilacak. Dalam
kasus sesi realtime, peristiwa disediakan secara langsung secara realtime
Buffer. Dalam kasus sesi berbasis file (yaitu jika jejak disimpan ke
.etl file), peristiwa diagregasi dan ditulis ke header file; mereka akan
menjadi salah satu peristiwa pertama yang disediakan runtime ETW ketika file .etl diputar
Kembali.

Peristiwa pelacakan biner akan memiliki id EventTraceGuid penyedia dan opcode
0x43.

Nilai ini didukung pada Windows 10, versi 1709, Windows Server, versi
1709, dan yang lebih baru.
TraceMaxLoggersQuery
Nilai: 19
Mengkueri jumlah maksimum sesi pengelogan ETW yang saat ini dikonfigurasi yang diizinkan
oleh sistem operasi. Mengembalikan ULONG. Digunakan dengan
EnumerateTraceGuidsEx.

Nilai ini didukung pada Windows 10, versi 1709, Windows Server, versi
1709, dan yang lebih baru.
TraceLbrConfigurationInfo
Nilai: 20
Mengaktifkan pelacakan Rekaman Cabang Terakhir untuk sesi yang diberikan, dan mengonfigurasi
filter LBR yang sesuai.

Nilai ini didukung pada Windows 10, versi 19H1, Windows Server, versi
1903, dan yang lebih baru.
TraceLbrEventListInfo
Nilai: 21
Mengonfigurasi daftar peristiwa yang akan memicu ETW untuk melacak Rekaman Cabang Terakhir
informasi seperti yang dikonfigurasi oleh TraceLbrConfigurationInfo.

Nilai ini didukung pada Windows 10, versi 19H1, Windows Server, versi
1903, dan yang lebih baru.
TraceMaxPmcCounterQuery
Nilai: 22
Mengkueri jumlah maksimum sumber pembuatan profil yang mungkin secara bersamaan
dikonfigurasi untuk digunakan dengan ETW.

Nilai ini didukung pada Windows 10, versi 19H1, Windows Server, versi
1903, dan yang lebih baru.
TraceStreamCount
Nilai: 23
Mengkueri jumlah aliran yang dikonfigurasi untuk sesi. Ini biasanya, tetapi tidak
selalu, sama dengan jumlah prosesor pada sistem, atau 1 jika tidak
buffering per prosesor dikonfigurasi untuk sesi.

Nilai ini didukung pada Windows 10, versi 21H2, Windows Server 2022, dan
nanti.
TraceStackCachingInfo
Nilai: 24
Menginstruksikan ETW untuk memulai penembolokan jejak tumpukan untuk berbasis RegisterTraceGuids
Acara ("Klasik") dalam sesi ini.

Nilai ini didukung pada Windows 10, versi 21H2, Windows Server 2022, dan
nanti.
TracePmcCounterOwners
Nilai: 25
Kueri ETW untuk daftar penghitung pemantauan performa prosesor yang saat ini ada
Menggunakan. Daftar ini mungkin berisi penghitung yang digunakan oleh fasilitas selain ETW.

Nilai ini didukung pada Windows 10, versi 21H2, Windows Server 2022, dan
nanti.
TraceUnifiedStackCachingInfo
Nilai: 26
Menginstruksikan ETW untuk memulai penembolokan jejak tumpukan untuk berbasis RegisterTraceGuids
("Klasik") dan peristiwa berbasis EventRegister.

Nilai ini didukung pada Windows 10, versi 21H2, Windows Server 2022, dan
nanti.
TracePmcSessionInformation
Nilai: 27
Kueri semua sesi untuk konfigurasi PMC mereka yang diatur melalui TracePmcEventListInfo dan TracePmcCounterListInfo.

Nilai ini didukung pada Windows 10, versi 22H2 dan yang lebih baru.
TraceContextRegisterInfo
Nilai: 28
Mengonfigurasi sesi dengan daftar peristiwa sistem tempat daftar konteks
peristiwa akan dikumpulkan. Peristiwa register konteks berisi register CPU
konten saat peristiwa terkait yang ditentukan diaktifkan.

Nilai ini didukung pada Windows Server 23H2 dan yang lebih baru.
MaxTraceSetInfoClass
Nilai: 29
Menandai nilai terakhir dalam enumerasi. Jangan gunakan.

Keterangan

Enumerasi TRACE_INFO_CLASS dan TRACE_QUERY_INFO_CLASS keduanya menentukan nilai yang sama. Gunakan kedua enumerasi dengan fungsi EnumerateTraceGuidsEx atau fungsi TraceSetInformation .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Header evntrace.h

Lihat juga

EnumerateTraceGuidsEx

TraceSetInformation