SDK Vizualizéru souběžnosti

Zdrojový kód můžete instrumentovat pomocí sady SDK Vizualizéru souběžnosti k zobrazení dalších informací ve Vizualizéru souběžnosti. Další data můžete přidružit k fázím a událostem v kódu. Tyto další vizualizace se označují jako značky. Úvodní návod najdete v tématu Představení sady SDK Vizualizéru souběžnosti.

Vlastnosti

Příznaky, rozsahy a zprávy mají dvě vlastnosti: kategorii a důležitost. V dialogovém okně Upřesnit Nastavení můžete pomocí těchto vlastností filtrovat sadu zobrazených značek. Kromě toho tyto vlastnosti ovlivňují vizuální znázornění značek. Například velikost příznaků se používá k reprezentaci důležitosti. Kromě toho se barva používá k označení kategorie.

Základní použití

Vizualizér souběžnosti zveřejňuje výchozího zprostředkovatele, kterého můžete použít ke generování značek. Zprostředkovatel je už zaregistrovaný společně s Vizualizérem souběžnosti a nemusíte dělat nic jiného, aby se značky zobrazovaly v uživatelském rozhraní.

C# a Visual Basic

V jazyce C#, Visual Basic a jiném spravovaném kódu použijte výchozího zprostředkovatele voláním metod ve třídě Markers . Zveřejňuje čtyři metody pro generování značek: WriteFlag, EnterSpan, WriteMessage a WriteAlert. Pro tyto funkce existuje více přetížení v závislosti na tom, jestli chcete pro vlastnosti použít výchozí hodnoty. Nejjednodušší přetížení přebírá pouze řetězcový parametr, který určuje popis události. Popis se zobrazí v sestavách Vizualizéru souběžnosti.

Přidání podpory sady SDK do projektu jazyka C# nebo Visual Basic

1. Na řádku nabídek zvolte Analyzovat, Vizualizér souběžnosti a přidejte do projektu sadu SDK.

2. Vyberte projekt, ve kterém chcete získat přístup k sadě SDK, a pak zvolte tlačítko Přidat sadu SDK do vybraného projektu .

3. Přidejte do kódu příkaz import nebo using.

   C#

   using Microsoft.ConcurrencyVisualizer.Instrumentation;
   

   VB

   Imports Microsoft.ConcurrencyVisualizer.Instrumentation
   

C++

V jazyce C++ vytvořte objekt třídy marker_series a použijte ho k volání funkcí. Třída marker_series zveřejňuje tři funkce pro generování značek, marker_series::write_flag Method, marker_series::write_message Method a marker_series::write_alert Method.

Přidání podpory sady SDK do projektu C++ nebo C

1. Na řádku nabídek zvolte Analyzovat, Vizualizér souběžnosti a přidejte do projektu sadu SDK.

2. Vyberte projekt, ve kterém chcete získat přístup k sadě SDK, a pak zvolte tlačítko Přidat sadu SDK do vybraného projektu .

3. V jazyce C++ zahrňte cvmarkersobj.h. V případě jazyka C zahrňte cvmarkers.h.

4. Přidejte do kódu příkaz using.

   using namespace Concurrency::diagnostic;
   

5. Vytvořte marker_series objekt a předejte ho konstruktoru span .

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

Vlastní využití

V případě pokročilých scénářů sada SDK Vizualizéru souběžnosti zpřístupňuje větší kontrolu. K pokročilejším scénářům jsou přidruženy dva hlavní koncepty: zprostředkovatelé značek a řada značek. Zprostředkovatelé značek jsou různí poskytovatelé Trasování událostí pro Windows (každý má jiný identifikátor GUID). Řady značek jsou sériové kanály událostí generovaných jedním poskytovatelem. Můžete je použít k uspořádání událostí generovaných poskytovatelem značek.

Použití nového zprostředkovatele značek v projektu jazyka C# nebo Visual Basic

1. Vytvořte objekt MarkerWriter . Konstruktor přebírá identifikátor GUID.

2. Pokud chcete poskytovatele zaregistrovat, otevřete dialogové okno Advanced Nastavení vizualizéru souběžnosti. Vyberte kartu Značky a pak zvolte tlačítko Přidat nového zprostředkovatele. V dialogovém okně Upřesnit Nastavení zadejte identifikátor GUID použitý k vytvoření zprostředkovatele a popis zprostředkovatele.

Použití nového zprostředkovatele značek v projektu C++ nebo C

1. CvInitProvider Pomocí funkce inicializujete PCV_PROVIDER. Konstruktor přebírá identifikátor GUID* a PCV_PROVIDER*.

2. Pokud chcete poskytovatele zaregistrovat, otevřete dialogové okno Upřesnit Nastavení. Vyberte kartu Značky a pak zvolte tlačítko Přidat nového zprostředkovatele. V tomto dialogovém okně zadejte identifikátor GUID použitý k vytvoření zprostředkovatele a popis zprostředkovatele.

Použití řady značek v projektu jazyka C# nebo Visual Basic

1. Chcete-li použít nový MarkerSeries, nejprve jej vytvořte pomocí MarkerWriter objektu a pak vygenerujte události značek přímo z nové řady.

   C#

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

   VB

   Dim series1 As New myMarkerWriter.CreateMarkerSeries("Series 1")
   series1.WriteFlag("My flag")
   

Použití řady značek v projektu C++

1. Vytvoření objektu marker_series Z této nové řady můžete generovat události.

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

Použití řady značek v projektu jazyka C

1. CvCreateMarkerSeries Pomocí funkce vytvořte PCV_MARKERSERIES.

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

Viz také

Titulek	Popis
Referenční dokumentace knihovny C++	Popisuje rozhraní API Vizualizéru souběžnosti pro C++.
Referenční informace ke knihovně jazyka C	Popisuje rozhraní API Vizualizéru souběžnosti pro jazyk C.
Instrumentation	Popisuje rozhraní API Vizualizéru souběžnosti pro spravovaný kód.
Vizualizér souběžnosti	Referenční informace pro zobrazení a sestavy datových souborů profilace, které jsou generovány pomocí metody souběžnosti a které zahrnují data spuštění vlákna.