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 |