Makro TraceLoggingOpcode (traceloggingprovider.h)

  • Artikel

Makro pembungkus TraceLogging yang mengatur opcode untuk peristiwa tersebut.

Sintaks

void TraceLoggingOpcode(
  [in]  eventOpcode
);

Parameter

[in] eventOpcode

Angka 8-bit yang digunakan untuk menandai peristiwa dengan semantik khusus. Nilai ini harus berupa konstanta waktu kompilasi dalam rentang 0 hingga 255.

Opcode akan digunakan oleh pelacakan dekoder untuk mengatur dan menghubungkan peristiwa. Nilai opcode yang diakui secara global didefinisikan dalam winmeta.h. Sebagian besar peristiwa menggunakan 0 (WINEVENT_OPCODE_INFO) untuk menunjukkan bahwa peristiwa tidak memiliki semantik khusus. Nilai opcode 10 hingga 239 dapat diberikan semantik yang ditentukan pengguna.

Lihat EVENT_DESCRIPTOR untuk detail tentang opcode peristiwa.

Mengembalikan nilai

Tidak ada

Keterangan

TraceLoggingOpcode(eventOpcode) dapat digunakan sebagai parameter untuk pemanggilan makro TraceLoggingWrite untuk mengatur opcode peristiwa.

Jika tidak ada makro TraceLoggingOpcode yang disediakan untuk panggilan TraceLoggingWrite , opcode default peristiwa adalah 0 (WINEVENT_OPCODE_INFO). Jika beberapa makro TraceLoggingOpcode disediakan, nilai terakhir digunakan.

Opcodes WINEVENT_OPCODE_START (1) dan WINEVENT_OPCODE_STOP (2) digunakan untuk menunjukkan awal dan akhir aktivitas ETW sebagai berikut:

  1. Buat ID aktivitas yang unik dalam pelacakan, biasanya menggunakan EventActivityIdControl atau UuidCreate.
  2. Tulis peristiwa awal dengan opcode = START, ID aktivitas = ID aktivitas yang dihasilkan, dan ID aktivitas terkait = ID aktivitas induk (atau NULL jika tidak ada ID aktivitas induk).
  3. Tulis sejumlah peristiwa informasi aktivitas dengan opcode = INFO, ID aktivitas = ID aktivitas yang dihasilkan.
  4. Tulis peristiwa berhenti dengan opcode = STOP, ID aktivitas = ID aktivitas yang dihasilkan.

Alat pendekodean jejak kemudian akan dapat mengatur peristiwa ini ke dalam grup berdasarkan ID aktivitas mereka.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header traceloggingprovider.h

Lihat juga

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

Makro pembungkus TraceLogging