同時実行ビジュアライザー SDK

[アーティクル]
02/21/2013

ソースコードを実装するには、同時実行制御ビジュアライザーの SDK を使用して、同時実行制御ビジュアライザーに表示する追加情報。フェーズとイベントをコードで追加のデータを関連付けることができます。これら追加の視覚エフェクトとして知られているマーカー。入門チュートリアルについてを参照してください、同時実行制御ビジュアライザー SDK を導入する。

プロパティ

フラグ、スパン、およびメッセージの各 2 つのプロパティがあります。カテゴリと重要性。詳細設定ダイアログボックスを使用できますこれらのプロパティに表示されるマーカーのセットをフィルター処理します。さらに、これらのプロパティには、マーカーの視覚的な表現に影響します。たとえば、フラグのサイズの重要性を表すために使用します。さらに、カラーカテゴリを示すために使用されます。

基本的な使用法

同時実行制御ビジュアライザーは、マーカーを生成するために使用できる、既定のプロバイダーを公開します。同時実行制御ビジュアライザーと共に、プロバイダーが既に登録されているし、UI に表示するマーカーを作成するには、他の操作する必要はありません。

C# と Visual Basic

C#、Visual basic、およびその他のマネージコードで、呼び出すことによって、既定のプロバイダーを使用してMarkers。マーカーを生成するための 4 つの機能を公開します。 WriteFlag、 EnterSpan、 WriteMessage、およびWriteAlert。プロパティの既定値を使用するかどうかに応じて、これらの関数は複数のオーバーロードされます。最も簡単なオーバーロードは、イベントの説明を指定します。文字列パラメーターのみかかります。説明は、同時実行制御ビジュアライザーのレポートが表示されます。

C# または Visual Basic プロジェクトに SDK のサポートを追加するのには

メニューバーを選択分析、 同時実行制御ビジュアライザー、 プロジェクトに追加の SDK。
SDK にアクセスし、選択するプロジェクトの選択、 プロジェクトを選択するのには、追加の SDK ボタン。

インポートまたは using ステートメントをコードに追加します。

using Microsoft.ConcurrencyVisualizer.Instrumentation;

Imports Microsoft.ConcurrencyVisualizer.Instrumentation

C++

C++ では、作成、 marker_series クラスオブジェクトし、関数を呼び出すために使用します。marker_seriesクラスは、マーカーを生成するための 3 つの機能を公開、 marker_series::write_flag メソッド、 marker_series::write_message メソッド、およびmarker_series::write_alert メソッド。

SDK のサポートは、C++ または C のプロジェクトに追加するのには

メニューバーを選択分析、 同時実行制御ビジュアライザー、 プロジェクトに追加の SDK。
SDK にアクセスし、選択するプロジェクトの選択、 プロジェクトを選択するのには、追加の SDK ボタン。
C++ 場合にはが含まれますcvmarkersobj.h。C はcvmarkers.h。
使用して追加するには、コードステートメント。
```
using namespace Concurrency::diagnostic;
```
作成、 marker_seriesオブジェクトし、それに渡す、 spanコンストラクター。
```
marker_series mySeries;
span s(mySeries, _T("Span description"));
```

ユーザー設定の使用

高度なシナリオでは、同時実行制御ビジュアライザーの SDK をより制御を公開します。2 つの主要な概念より高度なシナリオに関連します。マーカーのプロバイダーとデータ系列のマーカー。マーカーのプロバイダーは、(それぞれの異なる GUID は) 別の ETW プロバイダーです。マーカーシリーズシリアルチャネルの 1 つのプロバイダーによって生成されるイベントです。マーカーのプロバイダーによって生成されるイベントを整理するのにを使用できます。

C# または Visual Basic のプロジェクトで、新しいマーカーのプロバイダーを使用するのには

MarkerWriter オブジェクトを作成します。コンストラクターは GUID を使用します。
プロバイダーを登録するには、同時実行制御ビジュアライザーを開く詳細設定ダイアログボックス。選択、 マーカー タブをクリックし、選択、 新しいプロバイダーを追加するボタン。詳細設定ダイアログボックスに、プロバイダーとプロバイダーの説明の作成に使用した GUID を入力します。

C++ または C のプロジェクトで、新しいマーカーのプロバイダーを使用するのには

使用して、 CvInitProvider 、PCV_PROVIDER を初期化しなければなりません。コンストラクターは、GUID * や PCV_PROVIDER を使用します。
プロバイダーを登録するには、開く、詳細設定ダイアログボックス。選択、 マーカー タブをクリックし、選択、 新しいプロバイダーを追加するボタン。このダイアログボックスでは、プロバイダーとプロバイダーの説明の作成に使用した GUID を入力します。

C# または Visual Basic のプロジェクトの一連のマーカーを使用するのには

MarkerSeriesを使用して作成、 MarkerWriterオブジェクト、および新しいシリーズから直接、マーカーのイベントを生成します。

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

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

C++ プロジェクトの一連のマーカーを使用するには

marker_series オブジェクトを作成します。この新しいシリーズからイベントを生成することができます。
```
marker_series series;
series.write_flag(_T("Hello world!"));
```

C のプロジェクトの一連のマーカーを使用するのには

使用して、 CvCreateMarkerSeries 、PCV_MARKERSERIES を作成します。

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

Title	Description
C++ ライブラリリファレンス	同時実行制御ビジュアライザー API は C++ について説明します。
C ライブラリリファレンス	同時実行制御ビジュアライザー API は"c"を説明します。
Microsoft.ConcurrencyVisualizer.Instrumentation	同時実行制御ビジュアライザー API はマネージコードについて説明します。
同時実行ビジュアライザー	同時実行方式を使用して生成され、スレッド実行データを含むプロファイルデータファイルのビューとレポートに関するリファレンス情報。

次の方法で共有