Aracılığıyla paylaş

TraceLogging Başvurusu

  • Makale

Aşağıdaki konular C/C++ TraceLogging API'si hakkında bilgi sağlar.

Not

C/C++ kodundan olaylar oluşturuyorsanız ve olaylar derleme zamanında tanımlanıyorsa, bu bölümde açıklanan API'leri kullanın. Aksi takdirde, .NET kodundan olay oluşturuyorsanız .NET EventSource sınıfını kullanın. Aksi takdirde, Windows Çalışma Zamanı (WinRT) kullanıyorsanız LoggingChannelkullanın. Aksi takdirde, TraceLoggingDynamicgibi topluluk tarafından desteklenen bir seçenek kullanabilirsiniz.

TraceLogging, Windows için Olay İzleme (ETW) üzerinde oluşturulur ve kullanımı bildirim tabanlı ETW veya WPP'den daha kolaydır. TraceLogging yapılandırılmış veriler içeren olaylar oluşturmanıza olanak tanır, ETW etkinliklerini kullanarak olay bağıntısını destekler ve kod çözme için ayrı bir izleme bildirimi XML dosyası gerektirmez.

TraceLoggingProvider.h, kullanıcı veya çekirdek modundaki C/C++ geliştiricileri için önerilen API'dir. Aşağıdaki bağlantılarda C/C++ API'si açıklanmaktadır.

WINVER değerinin (kullanıcı modu) TraceLoggingProvider.h'nin davranışını etkileyeceğini unutmayın:

  • <windows.h>dahil edilmeden önce WINVER ayarlanmamışsa, <windows.h> WINVER'i SDK sürümüne karşılık gelen varsayılan bir değere ayarlar.
  • WINVER 0x0602 (Windows 8) veya üzeri olarak ayarlanmış TraceLoggingProvider.h kullanıyorsanız, program Windows Vista veya Windows 7'de çalışmayabilir (TraceLoggingProvider.h, Windows Vista veya Windows 7'nin RTM sürümlerinde bulunmayan EventSetInformation'ı doğrudan kullanmaya çalışır).
  • WINVER 0x0600 (Windows Vista) veya 0x0601 (Windows 7) olarak ayarlanmış TraceLoggingProvider.h kullanırsanız, program uyumluluk için yapılandırılır ve belirtilen Windows sürümlerinde çalışır (varsa TraceLoggingProvider.h, GetProcAddress aracılığıyla EventSetInformation'ı çağırır).