Sdílet prostřednictvím

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í 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 již zaregistrován spolu s nástrojem Concurrency Visualizer, takže nemusíte dělat nic, aby se značky zobrazily v 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.

    using 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 Metoda, marker_series::write_message Metoda a marker_series::write_alert Metoda.

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: poskytovatelé značek a série značek. Poskytovatelé značek jsou různí poskytovatelé ETW (každý má jiný GUID identifikátor). Ř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řijímá globální jedinečný identifikátor (GUID).

  2. Pokud chcete poskytovatele zaregistrovat, otevřete dialogové okno Upřesnit 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 poskytovatele značek v projektu C++ nebo C

  1. K inicializaci PCV_PROVIDER použijte funkci CvInitProvider. 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.

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

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

  1. Vytvořte objekt 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. Pomocí funkce CvCreateMarkerSeries vytvořte PCV_MARKERSERIES.

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

Viz také

Title Description
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.
instrumentace 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.
  • Last updated on