Makro TraceLoggingLevel (traceloggingprovider.h)

Makro pembungkus TraceLogging yang mengatur tingkat untuk peristiwa.

Sintaks

void TraceLoggingLevel(
  [in]  eventLevel
);

Parameter

[in] eventLevel

Angka 8-bit yang digunakan untuk menjelaskan tingkat keparahan atau kepentingan peristiwa. Nilai ini harus berupa konstanta waktu kompilasi dalam rentang 0 hingga 255. Jika tidak ada argumen TraceLoggingLevel yang disediakan untuk panggilan TraceLoggingWrite , tingkat peristiwa akan default ke 5 (WINEVENT_LEVEL_VERBOSE).

Penting

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

Lihat EVENT_DESCRIPTOR untuk detail tentang tingkat peristiwa.

Mengembalikan nilai

Tidak ada

Keterangan

TraceLoggingLevel(eventLevel) dapat digunakan sebagai parameter untuk pemanggilan makro TraceLoggingWrite untuk mengatur tingkat peristiwa. Tingkat peristiwa adalah sarana utama untuk memfilter peristiwa. Selalu tetapkan tingkat yang bermakna (non-nol) ke setiap peristiwa.

Jika tidak ada makro TraceLoggingLevel yang disediakan untuk panggilan TraceLoggingWrite , tingkat default peristiwa adalah 5 (WINEVENT_LEVEL_VERBOSE). Jika beberapa makro TraceLoggingLevel disediakan, nilai terakhir digunakan.

Nilai tingkat 0 hingga 5 ditentukan oleh Microsoft (lihat evntrace.h dan winmeta.h). Nilai tingkat 6 hingga 15 dicadangkan untuk definisi di masa mendatang oleh Microsoft. Nilai tingkat 16 hingga 255 dapat ditentukan oleh penyedia peristiwa.

Nilai	Semantik
LOG_ALWAYS (0)	Peristiwa melewati pemfilteran peristiwa berbasis tingkat. Peristiwa tidak boleh menggunakan tingkat ini.
KRITIS (1)	Kesalahan kritis
KESALAHAN (2)	Kesalahan
PERINGATAN (3)	Peringatan
INFO (4)	Informasi
VERBOSE (5)	Verbose

Sesi pengumpulan peristiwa dapat mengatur filter tingkat, yang berarti bahwa sesi hanya akan menerima peristiwa di mana eventDescriptor.Level <= session.LevelFilter. Perhatikan bahwa peristiwa dengan tingkat 0 akan melewati pemfilteran berbasis tingkat.

Contoh

TraceLoggingWrite(
    g_hMyProvider,
    "MyWarningEventName",
    TraceLoggingLevel(WINEVENT_LEVEL_WARNING), // Levels defined in <winmeta.h>
    TraceLoggingKeyword(MyNetworkingKeyword), // Provider-defined keyword
    TraceLoggingHResult(errorCode, "Error"));

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