Bagikan melalui

struktur ETW_OPEN_TRACE_OPTIONS (evntrace.h)

  • Artikel

Menyediakan parameter konfigurasi untuk fungsi OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions .

Sintaks

typedef struct ETW_OPEN_TRACE_OPTIONS {
  ETW_PROCESS_TRACE_MODES ProcessTraceModes;
  PEVENT_RECORD_CALLBACK  EventCallback;
  void                    *EventCallbackContext;
  PETW_BUFFER_CALLBACK    BufferCallback;
  void                    *BufferCallbackContext;
} ETW_OPEN_TRACE_OPTIONS;

Anggota

ProcessTraceModes

Enum bitfield yang menyediakan konfigurasi lebih lanjut untuk sesi pemrosesan. Nilai yang didukung saat ini:

  • ETW_PROCESS_TRACE_MODE_NONE
  • ETW_PROCESS_TRACE_MODE_RAW_TIMESTAMP – Tanda waktu dalam EVENT_RECORD yang disediakan ke EventCallback tidak akan dikonversi ke waktu file seperti secara default. Sebaliknya, mereka akan tetap dalam jenis jam peristiwa asli (misalnya QueryPerformanceCounter, penghitung tanda waktu CPU, atau GetSystemTimeAsFileTime).

EventCallback

Penunjuk fungsi jenis PEVENT_RECORD_CALLBACK. Dipanggil untuk setiap peristiwa dalam urutan waktu. Jika NULL maka semua pemrosesan pemutaran peristiwa akan dilewati untuk meningkatkan performa.

EventCallbackContext

Konteks yang ditentukan pengguna yang akan tersedia dalam EVENT_RECORD. UserContext di dalam EventCallback.

BufferCallback

Dipanggil untuk setiap buffer setelah pemrosesan pada buffer tersebut selesai. Jika NULL maka tidak ada panggilan balik buffer yang akan dijalankan.

BufferCallbackContext

Konteks yang ditentukan pengguna yang akan diteruskan ke BufferCallback sebagai parameter CallbackContext.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Header evntrace.h