Olayları Tüketme (Olay İzleme)

Olay izleme tüketicileri bir veya daha fazla sağlayıcıdan gelen olayları işleyebilir. Tüketiciler olayları bir günlük dosyasından veya gerçek zamanlı olarak işleyebilir. Yalnızca denetleyici oturum için gerçek zamanlı günlük modunu belirtiyorsa olayları gerçek zamanlı olarak kullanabilirsiniz. Performans nedenleriyle, Windows Vista'nın öncesinde gerçek zamanlı işleme önerilmez.

Olayları işlemek istediğiniz izleme oturumunu belirtmek için EVENT_TRACE_LOGFILE yapısını kullanırsınız. İşlemek istediğiniz her günlük dosyası veya gerçek zamanlı oturum için bu yapının bir kopyasını başlatmanız gerekir.

Günlük dosyasındaki olayları tüketmek için LogFileName üyesini, günlük dosyasının adı olarak ayarlayın. Gerçek zamanlı oturumdaki olayları kullanmak için LoggerName üyesini oturum adı olarak ayarlayın. Bu yapıyı ayrıca olayları işlemek için kullanılan BufferCallback geri çağırma ve EventCallback veya EventRecordCallback geri çağırmayı belirtmek için kullanırsınız.

• eventRecordCallback—Bir veya daha fazla günlük dosyasından ve gerçek zamanlı oturumdan tüm olayları (üst bilgi olayı dahil) alır ve işler. Olay verilerini ayrıştırmak için izleme verileri yardımcı işlevlerini kullanıyorsanız veya olayla ilgili meta verileri almak istiyorsanız bu geri çağırmayı uygularsınız.
• EventCallback—Bir veya daha fazla günlük dosyasından ve gerçek zamanlı oturumdan tüm olayları (üst bilgi olayı dahil) alır ve işler.
• BufferCallback—Kaybolan olaylar gibi geçerli arabellek hakkındaki özet bilgileri alır ve işler. ETW, arabellekteki tüm olayları tüketiciye teslim ettikten sonra geri çağırma fonksiyonunu çağırır. Tüketici bu geri çağırmayı olay işlemeyi iptal etmek için de kullanabilir; ancak olayları gerçek zamanlı olarak kullanıyorsanız ETW, denetleyici oturumu durdurana kadar olayları teslim eder.

Bir veya daha fazla izleme oturumu tanımladıktan sonra, işlemek istediğiniz her izleme oturumu için OpenTrace işlevini çağırın; olayları bir veya daha fazla günlük dosyasından ancak yalnızca bir gerçek zamanlı oturumdan işleyebilirsiniz. Ardından, OpenTrace tarafından döndürülen izleme oturumu tanıtıcılarının listesini ProcessTrace işlevine geçirirsiniz. ProcessTrace işlevi olayları birleştirir, bunları kronolojik olarak sıralar ve ardından her birini sırayla geri çağırma yöntemlerine iletir. Olaylar, yalnızca StartTime ve EndTime parametreleri kullanılarak belirli bir zaman dilimine girenleri içerecek şekilde filtrelenebilir. ProcessTrace işlevi, tüketiciniz izleme oturumlarındaki tüm olayları işleyene, BufferCallbackFALSEdöndürene veya CloseTraceçağırana kadar iş parçacığını engeller.

Windows Vista öncesi :CloseTrace yalnızca ProcessTrace geri döndüğünde çağırabilirsiniz.

Bildirim, MOF veya TMF dosyaları kullanılarak yayımlanan olayların nasıl tüketildiğini gösteren bir örnek için bkz. TDH Kullanarak Olay Verilerini Alma. Windows Vista'dan itibaren, olayları tüketmek için izleme verisi yardımcı işlevlerini (TDH) kullanmanız gerektiğini unutmayın.

MOF kullanılarak yayımlanan olayların nasıl tüketildiğini gösteren bir örnek için bkz. MOF Kullanarak Olay Verilerini Alma.