Fungsi OpenTraceFromRealTimeLoggerWithAllocationOptions (evntrace.h)

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

Sintaks

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLoggerWithAllocationOptions(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  ULONG_PTR                    AllocationSize,
  HANDLE                       MemoryPartitionHandle,
  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 OpenTraceFromRealTimeLoggerWithAllocationOptions untuk menggunakan data dari sesi real-time.

Saat memanggil OpenTraceFromRealTimeLoggerWithAllocationOptions, jika LogFileHeadernon-NULL maka LoggerName harus NULL.

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

Hanya pengguna dengan hak istimewa 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 mengonsumsi 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.

AllocationSize

Ukuran, dalam byte, memori yang akan dialokasikan sebelumnya untuk menyimpan buffer ETW selama pemrosesan. Alokasi yang lebih besar akan mengurangi kebutuhan akan alokasi individu/panggilan gratis dengan biaya penggunaan memori yang lebih konsisten. Ini akan disesuaikan ke atas hingga minimum total ruang buffer dari sesi ETW Real-Time yang mendasar untuk memastikan cukup dialokasikan untuk fungsi dasar. Jika 0, ukuran default akan digunakan.

MemoryPartitionHandle

Handel ke Partisi Memori yang harus digunakan untuk alokasi memori untuk sesi pemrosesan ini. Jika NULL, Partisi Memori proses akan digunakan. Lihat MemExtendedParameterPartitionHandle untuk detail selengkapnya.

LogFileHeader

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

Nilai kembali

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

Keterangan

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. Ini identik dengan OpenTraceFromRealTime kecuali memungkinkan penyesuaian alokasi memori untuk sesi pemrosesan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	evntrace.h
Pustaka	Sechost.lib di Windows 8.1 dan Windows Server 2012 R2; Advapi32.lib di Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista dan Windows XP
DLL	Sechost.dll di Windows 8.1 dan Windows Server 2012 R2; Advapi32.dll di Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista dan Windows XP