Bagikan melalui

Fungsi OpenTraceFromRealTimeLogger (evntrace.h)

Membuat sesi pemrosesan jejak yang dilampirkan ke sesi ETW real-time aktif.

Sintaksis

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

Parameter

LoggerName

Nama sesi pelacakan peristiwa real time, atau NULL jika memproses data dari file log. Tentukan nilai untuk anggota ini jika Anda memanggil OpenTraceFromRealTimeLogger untuk menggunakan data dari sesi real time.

Saat memanggilOpenTraceFromRealTimeLogger , jika LogFileHeader bukan NULL maka LoggerName harus NULL.

Anda hanya dapat menggunakan peristiwa secara real time jika pengontrol jejak telah mengatur LogFileMode anggota EVENT_TRACE_PROPERTIES untuk menyertakan bendera EVENT_TRACE_REAL_TIME_MODE.

Hanya pengguna dengan hak administratif, pengguna di grup Pengguna Log Performa, dan aplikasi yang berjalan sebagai LocalSystem, LocalService, NetworkService yang dapat mengonsumsi peristiwa secara real time. Untuk memberi pengguna terbatas kemampuan untuk menggunakan peristiwa secara real time, tambahkan mereka ke grup Pengguna Log Performa atau panggil EventAccessControl.

Options

Opsi konfigurasi untuk sesi pemrosesan ini. Lihat ETW_OPEN_TRACE_OPTIONS untuk detail selengkapnya.

LogFileHeader

Informasi header untuk file log. Lihat TRACE_LOGFILE_HEADER untuk detail selengkapnya.

Mengembalikan nilai

TRACEHANDLE yang digunakan untuk mengidentifikasi sesi pemrosesan ini. Biasanya diteruskan ke ProcessTrace untuk mulai memproses dan CloseTrace pemrosesan akhir.

Komentar

Setelah ProcessTrace dipanggil pada tracehandle yang dikembalikan, ini akan menerima buffer dari sesi ETW saat dibersihkan dan segera mulai memprosesnya dan memanggil panggilan balik yang ditentukan dalam Opsi .

Persyaratan

Syarat Nilai
klien minimum yang didukung Pembaruan Windows 11 2022
server minimum yang didukung Windows Server 2022
Platform Target Windows
Header evntrace.h
Pustaka Advapi32.dll
DLL Sechost.dll pada Windows 8.1 dan Windows Server 2012 R2; Advapi32.dll pada Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista dan Windows XP