Makro TraceLoggingKeyword (traceloggingprovider.h)

  • Artikel

Makro pembungkus TraceLogging yang mengatur kata kunci untuk peristiwa tersebut.

Sintaks

void TraceLoggingKeyword(
  [in]  eventKeyword
);

Parameter

[in] eventKeyword

Bitmask 64-bit yang digunakan untuk menunjukkan keanggotaan peristiwa dalam serangkaian kategori peristiwa. Nilai ini harus berupa konstanta waktu kompilasi.

Penting

ProviderId, Level, dan Keyword adalah sarana utama untuk memfilter peristiwa. Jenis pemfilteran lainnya dimungkinkan tetapi memiliki overhead yang jauh lebih tinggi. Selalu tetapkan tingkat non-nol dan kata kunci yang bermakna untuk setiap peristiwa.

Lihat EVENT_DESCRIPTOR untuk detail tentang kata kunci peristiwa.

Mengembalikan nilai

Tidak ada

Keterangan

TraceLoggingKeyword(eventKeyword) dapat digunakan sebagai parameter untuk pemanggilan makro TraceLoggingWrite untuk mengatur kata kunci peristiwa. Kata kunci peristiwa adalah sarana utama untuk memfilter peristiwa. Selalu tetapkan kata kunci yang bermakna (bukan nol) untuk setiap peristiwa.

Jika tidak ada makro TraceLoggingKeyword yang disediakan untuk panggilan TraceLoggingWrite , kata kunci default peristiwa adalah 0. Jika beberapa makro TraceLoggingKeyword disediakan, nilainya adalah OR'ed together.

16 bit teratas kata kunci (bitmask 0xFFFF000000000000) ditentukan oleh Microsoft. Kata kunci 48 bit rendah (bitmask 0x0000FFFFFFFFFFFF) ditentukan oleh penyedia peristiwa. Misalnya, penyedia peristiwa mungkin mendefinisikan bit 0 (bitmask 0x1) menjadi kategori "I/O", bit 1 (bitmask 0x2) menjadi kategori "UI", dan bit 2 (bitmask 0x4) menjadi kategori "pengukuran performa". Dalam skenario ini, peristiwa mungkin memiliki kata kuncinya yang diatur ke 0x5, menunjukkan bahwa peristiwa tersebut berada dalam kategori "I/O" dan "pengukuran performa".

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

TraceLoggingWrite

Makro pembungkus TraceLogging