Parallelitätsschnellansichts-SDK

Sie können Ihren Quellcode instrumentieren, indem Sie das SDK Parallelitätsschnellansicht verwenden, um zusätzliche Informationen in der Parallelitätsschnellansicht angezeigt.Sie können die weiteren Daten mit Phasen und Ereignisse im Code zu.Diese zusätzlichen Visualisierungen bekannt als Markierung. Eine dieser einführenden exemplarischen Vorgehensweise finden Sie unter Addition der Parallelitätsschnellansicht SDK.

Eigenschaften

Flags, Spannen und Meldungen ist jeweils zwei Eigenschaften: Kategorie und Bedeutung.Im Dialogfeld Erweiterte Einstellungen können Sie diese Eigenschaften verwenden, um den Satz von Markern zu filtern, die angezeigt werden.Darüber hinaus auswirken diese Eigenschaften die visuelle Darstellung von Markern.Beispielsweise wird die Größe aus Flags, die Bedeutung darzustellen.Darüber hinaus wird Farbe verwendet, um Kategorie anzugeben.

Grundlegende Verwendung

Die Parallelitätsschnellansicht macht einen Standardanbieter verfügbar den Sie verwenden können, um Markierungen zu generieren.Der Anbieter wurde bereits mit der Parallelitätsschnellansicht registriert und Sie müssen noch etwas nicht ausführen, um die Markierung zu erstellen, in der Benutzeroberfläche angezeigt wird.

C# und Visual Basic

In C# verwenden Visual Basic und anderer verwalteter Code, den Standardanbieter, indem Markers aufrufen.Es macht vier Funktionen zum Generieren von Markern verfügbar: 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 Beschreibung des Ereignisses angibt.Die Beschreibung wird in den Nebenläufigkeitsschnellansichtsberichten angezeigt.

So SDK-Unterstützung einem C#- oder einem Visual Basic-Projekt hinzufügen

1. Klicken Sie auf der Menüleiste Nebenläufigkeitsschnellansicht, SDK zum Projekt hinzufügen, Analysieren aus.

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

3. Hinzufügen von Importen oder Using-Anweisung dem Code hinzu.

   using Microsoft.ConcurrencyVisualizer.Instrumentation;
   

   Imports Microsoft.ConcurrencyVisualizer.Instrumentation
   

C++

In C++ erstellen Sie ein marker_series-Klasse-Objekt und verwenden Sie es, um Funktionen aufzurufen. Die marker_series-Klasse macht drei Funktionen zum Generieren von Markern, marker_series::write_flag-Methode, marker_series::write_message-Methode und marker_series::write_alert-Methode verfügbar.

Um SDK-Unterstützung eine C++-Datei C oder fügen Sie

1. Klicken Sie auf der Menüleiste Nebenläufigkeitsschnellansicht, SDK zum Projekt hinzufügen, Analysieren aus.

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

3. In C++ schließen Sie cvmarkersobj.h ein.In C schließen Sie cvmarkers.h ein.

4. Fügen Sie einer using-Anweisung dem Code hinzu.

   using namespace Concurrency::diagnostic;
   

5. Erstellen Sie ein marker_series-Objekt und übergeben Sie es an das span-Konstruktor.

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

Benutzerdefinierte Verwendung

Für erweiterte Szenarios macht das Parallelitätsschnellansicht SDK mehr Steuerelement verfügbar. Zwei Hauptkonzepte werden um mit komplexeren Szenarien zugeordnet: Markeranbieter und Marker-Reihe.Markeranbieter sind verschiedene ETW-Anbieter (jeder enthält eine andere GUID).Marker-Reihe ist serielle Kanal von Ereignissen, die durch einen Anbieter generiert werden.Sie können es verwenden, um die Ereignisse zu organisieren, die durch einen Markeranbieter generiert werden.

Um einen neuen Markeranbieter in einem C#- oder Visual Basic-Projekt verwenden

1. Erstellen eines MarkerWriter-Objekts Der Konstruktor akzeptiert eine GUID.

2. Um den Anbieter registriert, öffnen Sie das Dialogfeld Nebenläufigkeitsschnellansichts Erweiterte Einstellungen. Wählen Sie die Registerkarte Marker und wählen Sie dann die Schaltfläche Neuen Anbieter hinzufügen aus.Im Erweiterte Einstellungen Dialogfeld geben Sie die GUID ein, die verwendet wurde, um den Anbieter und eine Beschreibung des Anbieters zu erstellen.

Um einen neuen Markeranbieter in eine C++-Datei oder C zu verwenden Sie

1. Verwenden Sie die CvInitProvider-Funktion, um ein PCV_PROVIDER zu initialisieren. Der Konstruktor akzeptiert ein GUID* und ein PCV_PROVIDER*.

2. Um den Anbieter registriert, öffnen Sie das Dialogfeld Erweiterte Einstellungen. Wählen Sie die Registerkarte Marker und wählen Sie dann die Schaltfläche Neuen Anbieter hinzufügen aus.In diesem Dialogfeld geben Sie die GUID ein, die verwendet wurde, um den Anbieter und eine Beschreibung des Anbieters zu erstellen.

So Reihe einer Markierung in einem C#- oder Visual Basic-Projekt verwenden

• Um ein neues MarkerSeries zu verwenden, erstellen Sie es zuerst indem Sie ein MarkerWriter-Objekt verwenden, und generieren Sie dann Markerereignisse direkt von der neue Serie.

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

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

Um Reihe einer Markierung in eine C++-Datei zu verwenden Sie

• Erstellen eines marker_series-Objekts Sie können Ereignisse aus dieser neue Serie generieren.

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

Um einer Markierung in eine Reihe zu verwenden Sie

• Verwenden Sie die CvCreateMarkerSeries-Funktion, um ein PCV_MARKERSERIES zu erstellen.

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

Verwandte Themen