SDK do Visualizador de Concorrência

Você pode instrumentar o código-fonte usando o SDK do Visualizador Simultâneo para exibir informações adicionais no Visualizador Simultâneo. Você pode associar os dados adicionais a fases e eventos em seu código. Essas visualizações adicionais são conhecidas como marcadores. Para obter um passo a passo introdutório, consulte Introdução ao SDK do Visualizador simultâneo.

Propriedades

Sinalizadores, intervalos e mensagens têm duas propriedades: categoria e importância. Na caixa de diálogo Configurações Avançadas , você pode usar essas propriedades para filtrar o conjunto de marcadores exibidos. Além disso, essas propriedades afetam a representação visual dos marcadores. Por exemplo, o tamanho das bandeiras é usado para indicar a importância. Além disso, a cor é usada para indicar categoria.

Uso Básico

O Visualizador de Concorrência expõe um provedor padrão que pode ser usado para gerar marcadores. O provedor já está registrado em conjunto com o Concurrency Visualizer, e você não precisa fazer mais nada para que os marcadores apareçam na UI.

C# e Visual Basic

Em C#, Visual basic e outro código gerenciado, use o provedor padrão chamando métodos na classe Markers . Ele expõe quatro métodos para gerar marcadores: WriteFlag, EnterSpan, WriteMessage e WriteAlert. Há várias sobrecargas para essas funções, dependendo se você deseja usar padrões para as propriedades. A sobrecarga mais simples usa apenas um parâmetro de cadeia de caracteres que especifica a descrição do evento. A descrição é exibida nos relatórios do Concurrency Visualizer.

Para adicionar suporte ao SDK a um projeto C# ou Visual Basic

1. Na barra de menus, escolha Analisar, Visualizador Simultâneo, Adicionar SDK ao projeto.

2. Selecione o projeto no qual você deseja acessar o SDK e escolha o botão Adicionar SDK ao Projeto Selecionado .

3. Adicione uma instrução import ou using ao seu código.

   • C#
   • VB

   using Microsoft.ConcurrencyVisualizer.Instrumentation;
   

C++

No C++, crie um objeto de classe marker_series e use-o para chamar funções. A marker_series classe expõe três funções para gerar marcadores, o método marker_series::write_flag, o método marker_series::write_message e o método marker_series::write_alert.

Para adicionar suporte ao SDK a um projeto C++ ou C

1. Na barra de menus, escolha Analisar, Visualizador Simultâneo, Adicionar SDK ao projeto.

2. Selecione o projeto no qual você deseja acessar o SDK e escolha o botão Adicionar SDK ao Projeto Selecionado .

3. Para C++, inclua cvmarkersobj.h. Para C, inclua cvmarkers.h.

4. Adicione uma instrução using ao seu código.

   using namespace Concurrency::diagnostic;
   

5. Crie um marker_series objeto e passe-o para o span construtor.

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

Uso personalizado

Para cenários avançados, o SDK do Visualizador simultâneo expõe mais controle. Dois conceitos principais estão associados a cenários mais avançados: provedores de marcadores e séries de marcadores. Provedores de marcadores são provedores ETW distintos (cada um possui um GUID diferente). As séries de marcadores são canais seriais de eventos gerados por um provedor. Você pode usá-los para organizar os eventos gerados por um provedor de marcadores.

Para usar um novo provedor de marcadores em um projeto C# ou Visual Basic

1. Crie um objeto MarkerWriter . O construtor usa um GUID.

2. Para registrar o provedor, abra a caixa de diálogo Configurações Avançadas do Concurrency Visualizer. Selecione a guia Marcadores e, em seguida, escolha o botão Adicionar Novo Provedor . Na caixa de diálogo Configurações Avançadas, insira o GUID que foi usado para criar o provedor e uma descrição do provedor.

Para usar um novo provedor de marcadores em um projeto C++ ou C

1. Use a função CvInitProvider para inicializar um PCV_PROVIDER. O construtor recebe um GUID* e um PCV_PROVIDER*.

2. Para registrar o provedor, abra a caixa de diálogo Configurações Avançadas . Selecione a guia Marcadores e, em seguida, escolha o botão Adicionar Novo Provedor . Nesta caixa de diálogo, insira o GUID que foi usado para criar o provedor e uma descrição do provedor.

Para usar uma série de marcadores em um projeto C# ou Visual Basic

1. Para usar uma nova MarkerSeries, primeiro crie-a usando um objeto MarkerWriter e, em seguida, gere eventos de marcador diretamente da nova série.

   • C#
   • VB

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

Para usar uma série de marcadores em um projeto C++

1. Crie um objeto marker_series. Você pode gerar eventos a partir desta nova série.

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

Para usar uma série de marcadores em um projeto C

1. Use a CvCreateMarkerSeries função para criar um PCV_MARKERSERIES.

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

Consulte também