Parallelitätsschnellansichts-SDK

Sie können den Quellcode instrumentieren, mithilfe von Parallelität Schnellansicht SDK um zusätzliche Informationen in die Parallelität Schnellansicht anzuzeigen.Sie können die zusätzlichen Daten Phasen und Ereignissen zuzuordnen in Ihrem Code.Diese zusätzlichen Visualisierungen sind bekannt als Marker.Eine einführende Exemplarische finden Sie unter Einführung der Parallelität Schnellansicht SDK.

Eigenschaften

Flags, umfasst und Nachrichten verfügen über zwei Eigenschaften: Kategorie und Wichtigkeit.In der Erweiterte Einstellungen im Dialogfeld können Sie diese Eigenschaften um zu den Marken zu filtern, die angezeigt werden.Diese Eigenschaften beeinflussen außerdem die visuelle Darstellung von Marken.Beispielsweise wird die Größe des Flags verwendet, zum Darstellen von Bedeutung.Darüber hinaus wird Farbe verwendet, um Kategorie anzugeben.

Grundlegende Verwendung

Die Schnellansicht Parallelität macht einen Standardanbieter, den Sie verwenden können, um Markierungen zu generieren.Der Anbieter bereits zusammen mit der Parallelität Schnellansicht registriert ist, und Sie müssen nichts anderes machen die Marker in der Benutzeroberfläche angezeigt werden.

C#- und Visual Basic

Verwenden Sie den Standardanbieter in c#, Visual Basic und anderen verwalteten Code, durch den Aufruf Markers.Sie stellt vier Funktionen zum Generieren von Markierungen: WriteFlag, EnterSpan, WriteMessage, und WriteAlert.Es gibt mehrere Überladungen für diese Funktionen, je nachdem, ob Sie Standardwerte für die Eigenschaften verwenden möchten.Die einfachste Überladung akzeptiert nur einen Zeichenfolgenparameter, der die Beschreibung des Ereignisses angibt.Die Beschreibung wird in den Berichten Parallelität Schnellansicht angezeigt.

Eine C#- oder Visual Basic Projekt SDK-Unterstützung hinzu

1. Wählen Sie auf der Menüleiste Analyse, Parallelität Schnellansicht, SDK zu Projekt hinzufügen.

2. Wählen Sie das Projekt, in dem Sie zugreifen möchten das SDK und wählen dann, die SDK zum ausgewählten Projekt hinzufügen Schaltfläche.

3. Fügen Sie eine Imports-Anweisung oder using-Anweisung Code.

   using Microsoft.ConcurrencyVisualizer.Instrumentation;
   

   Imports Microsoft.ConcurrencyVisualizer.Instrumentation
   

C++

Erstellen Sie in C++ ein marker_series-Klasse -Objekts und Aufrufen von Funktionen verwenden.Die marker_series -Klasse stellt drei Funktionen zur Generierung von Markern, die marker_series::write_flag-Methode, die marker_series::write_message-Methode, und die marker_series::write_alert-Methode.

SDK-Unterstützung ein C++ oder C#-Projekt hinzu

1. Wählen Sie auf der Menüleiste Analyse, Parallelität Schnellansicht, SDK zu Projekt hinzufügen.

2. Wählen Sie das Projekt, in dem Sie zugreifen möchten das SDK und wählen dann, die SDK zum ausgewählten Projekt hinzufügen Schaltfläche.

3. Für C++ enthalten cvmarkersobj.h.Für C, enthalten cvmarkers.h.

4. Fügen Sie eine using-Anweisung, um Ihren Code.

   using namespace Concurrency::diagnostic;
   

5. Erstellen einer marker_series -Objekt, und übergeben sie an die span Konstruktor.

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

Benutzerdefinierte Usage

Für erweiterte Szenarien stellt die Parallelität Schnellansicht SDK mehr Kontrolle.Zwei Hauptkonzepte erweiterte Szenarien zugeordnet sind: Marker-Anbieter und Marker-Serie.Marker sind verschiedene ETW-Anbieter (jede hat eine andere GUID).Marker-Serie sind seriellen Kanäle von Ereignissen, die von einem Provider generiert werden.Sie können die Ereignisse zu organisieren, die von einem Anbieter Marker generiert werden.

Verwenden Sie einen neuen Marker-Anbieter in einem C#- oder Visual Basic

1. Erstellen eines MarkerWriter-ObjektsDer Konstruktor nimmt eine GUID.

2. Um den Provider zu registrieren, öffnen Sie die Parallelität Schnellansicht Erweiterte Einstellungen Dialogfeld.Wählen Sie die Marker Registerkarte, und wählen Sie dann die Neue Anbieter hinzufügen Schaltfläche.In der Erweiterte Einstellungen Dialogfeld geben Sie die GUID, die zum Erstellen der Anbieter und eine Beschreibung des Anbieters verwendet wurde.

Verwenden Sie einen neuen Marker-Anbieter in C++ oder C#-Projekt

1. Verwendung der CvInitProvider Funktion, um eine PCV_PROVIDER zu initialisieren.Der Konstruktor nimmt eine GUID und PCV_PROVIDER *.

2. Um den Provider zu registrieren, öffnen Sie die Erweiterte Einstellungen Dialogfeld.Wählen Sie die Marker Registerkarte, und wählen Sie dann die Neue Anbieter hinzufügen Schaltfläche.Geben Sie in diesem Dialogfeld die GUID, die zum Erstellen der Anbieter und eine Beschreibung des Anbieters verwendet wurde.

Verwenden Sie einen Marker-Serie in einem C#- oder Visual Basic

• Ein neues MarkerSeries, erstellen sie zunächst mithilfe einer MarkerWriter -Objekt und generieren dann direkt aus der neuen Serie Markerereignissen.

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

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

Verwenden Sie einen Marker-Serie in einem C++-Projekt

• Erstellen eines marker_series-ObjektsSie können Ereignisse aus dieser neuen Serie generieren.

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

Ein Marker-Serie in ein C-Projekt verwenden

• Verwendung der CvCreateMarkerSeries Funktion, um eine PCV_MARKERSERIES zu erstellen.

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

Verwandte Themen