Eşzamanlılık Görselleştiricisi SDK

Eşzamanlılık Görselleştiricisi'nde ek bilgileri görüntülemek için Eşzamanlılık Görselleştiricisi SDK'sını kullanarak kaynak kodunuzu izleyebilirsiniz. Ek verileri kodunuzdaki aşamalar ve olaylarla ilişkilendirebilirsiniz. Bu ek görselleştirmeler işaretçi olarak bilinir. Giriş niteliğinde bir izlenecek yol için bkz . Eşzamanlılık Görselleştiricisi SDK'sını tanıtma.

Özellikler

Bayraklar, yaymalar ve iletilerin her birinin iki özelliği vardır: kategori ve önem. Gelişmiş Ayarlar iletişim kutusunda, görüntülenen işaretçi kümesini filtrelemek için bu özellikleri kullanabilirsiniz. Ayrıca, bu özellikler işaretçilerin görsel gösterimini etkiler. Örneğin, bayrakların boyutu önem derecesini göstermek için kullanılır. Ayrıca, kategoriyi belirtmek için renk kullanılır.

Temel kullanım

Eşzamanlılık Görselleştiricisi, işaretçiler oluşturmak için kullanabileceğiniz varsayılan bir sağlayıcıyı kullanıma sunar. Sağlayıcı Eşzamanlılık Görselleştiricisi ile birlikte zaten kayıtlıdır ve işaretçilerin kullanıcı arabiriminde görünmesini sağlamak için başka bir şey yapmanız gerekmez.

C# ve Visual Basic

C#, Visual basic ve diğer yönetilen kodlarda markers sınıfında yöntemleri çağırarak varsayılan sağlayıcıyı kullanın. İşaretleyici oluşturmak için dört yöntem sunar: WriteFlag, EnterSpan, WriteMessage ve WriteAlert. Özellikler için varsayılan değerleri kullanmak isteyip istemediğinize bağlı olarak, bu işlevler için birden çok aşırı yükleme vardır. En basit aşırı yükleme yalnızca olayın açıklamasını belirten bir dize parametresi alır. Açıklama Eşzamanlılık Görselleştiricisi raporlarında görüntülenir.

C# veya Visual Basic projesine SDK desteği eklemek için

1. Menü çubuğunda Çözümle, Eşzamanlılık Görselleştiricisi, Projeye SDK ekle'yi seçin.

2. SDK'ya erişmek istediğiniz projeyi seçin ve ardından Seçili Projeye SDK Ekle düğmesini seçin.

3. Kodunuza içeri aktarmalar veya using deyimi ekleyin.

   • C#
   • VB

   using Microsoft.ConcurrencyVisualizer.Instrumentation;
   

C++

C++'ta bir marker_series Sınıfı nesnesi oluşturun ve işlevleri çağırmak için bunu kullanın. marker_series sınıfı, işaretçi oluşturmak için üç işlevi kullanıma sunar: marker_series::write_flag Yöntemi, marker_series::write_message Yöntemi ve marker_series::write_alert Yöntemi.

C++ veya C projesine SDK desteği eklemek için

1. Menü çubuğunda Çözümle, Eşzamanlılık Görselleştiricisi, Projeye SDK ekle'yi seçin.

2. SDK'ya erişmek istediğiniz projeyi seçin ve ardından Seçili Projeye SDK Ekle düğmesini seçin.

3. C++ için öğesini ekleyin cvmarkersobj.h. C için öğesini ekleyin cvmarkers.h.

4. Kodunuza bir using deyimi ekleyin.

   using namespace Concurrency::diagnostic;
   

5. Bir marker_series nesne oluşturun ve oluşturucuya span geçirin.

   
   marker_series mySeries;
   span s(mySeries, _T("Span description"));
   
   

Özel kullanım

Gelişmiş senaryolar için Eşzamanlılık Görselleştiricisi SDK'sı daha fazla denetim sunar. İki ana kavram daha gelişmiş senaryolarla ilişkilendirilir: işaret sağlayıcılar ve işaretçi serisi. İşaretçi sağlayıcıları farklı ETW sağlayıcılarıdır (her birinin farklı bir GUID'i vardır). İşaretçi serisi, bir sağlayıcı tarafından oluşturulan olayların seri kanallarıdır. Bir işaretçi sağlayıcısı tarafından oluşturulan olayları düzenlemek için bunları kullanabilirsiniz.

C# veya Visual Basic projesinde yeni bir işaretçi sağlayıcısı kullanmak için

1. MarkerWriter nesnesi oluşturun. Oluşturucu bir GUID alır.

2. Sağlayıcıyı kaydetmek için Eşzamanlılık Görselleştiricisi Gelişmiş Ayarlar iletişim kutusunu açın. İşaretçiler sekmesini ve ardından Yeni Sağlayıcı Ekle düğmesini seçin. Gelişmiş Ayarlar iletişim kutusunda, sağlayıcıyı oluşturmak için kullanılan GUID'yi ve sağlayıcının açıklamasını girin.

C++ veya C projesinde yeni bir işaretçi sağlayıcısı kullanmak için

1. CvInitProvider bir PCV_PROVIDER başlatmak için işlevini kullanın. Oluşturucu bir GUID* alır ve PCV_PROVIDER* alır.

2. Sağlayıcıyı kaydetmek için Gelişmiş Ayarlar iletişim kutusunu açın. İşaretçiler sekmesini ve ardından Yeni Sağlayıcı Ekle düğmesini seçin. Bu iletişim kutusunda, sağlayıcıyı oluşturmak için kullanılan GUID'yi ve sağlayıcının açıklamasını girin.

C# veya Visual Basic projesinde işaretçi serisi kullanmak için

1. Yeni bir MarkerSeries kullanmak için, önce bir MarkerWriter nesnesi kullanarak oluşturun ve ardından doğrudan yeni seriden işaretçi olayları oluşturun.

   • C#
   • VB

   MarkerSeries series1 = myMarkerWriter.CreateMarkerSeries("Series 1");
   series1.WriteFlag("My flag");
   

C++ projesinde işaretçi serisi kullanmak için

1. Bir marker_series nesne oluşturun. Bu yeni seriden olaylar oluşturabilirsiniz.

   marker_series series;
   series.write_flag(_T("Hello world!"));
   

C projesinde işaretçi serisi kullanmak için

1. CvCreateMarkerSeries bir PCV_MARKERSERIES oluşturmak için işlevini kullanın.

   PCV_MARKERSERIES series;
   CvCreatemarkerSeries(myProvider, _T("My Series"), &series);
   CvWriteFlag(series, _T("Writing a flag"));
   

Ayrıca bkz.