SDK do Visualizador de Simultaneidade

Artigo
06/08/2015

Você pode prover seu código-fonte usando o visualizador SDK de simultaneidade para exibir informações adicionais do visualizador de simultaneidade.Você pode associar os dados adicionais com as fases e eventos em seu código.Estas visualizações adicionais são conhecidos como marcadores. Para obter um passo a passo introdutório, consulte Apresentando o visualizador SDK de simultaneidade.

Propriedades

Os sinalizadores, períodos, e as mensagens cada um tem duas propriedades: categoria e importância.Na caixa de diálogo de 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 dos sinalizadores é usada para representar a importância.Além disso, a cor é usada para indicar a categoria.

Uso básico

O visualizador de simultaneidade expõe um provedor padrão que você pode usar para gerar marcadores.O provedor já estiver registrado junto com o visualizador de simultaneidade e não é necessário fazer mais nada para tornar os marcadores exibidos na interface do usuário.

C# e Visual Basic

No C#, Visual Basic, e o outro código gerenciado, usam o provedor padrão chamando Markers.Expõe quatro funções para gerar marcadores: WriteFlag, EnterSpan, WriteMessage, e WriteAlert.Há várias sobrecargas dessas funções, dependendo se desejar usar opções para as propriedades. A sobrecarga a mais simples só um parâmetro de cadeia de caracteres que especifica a descrição do evento.A descrição é exibida em relatórios do visualizador de simultaneidade.

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

Na barra de menus, escolha Analisar, Concurrency Visualizer, Adicionar SDK ao Projeto.
Selecione o projeto em que você deseja acessar o SDK e escolha o botão de Adicionar SDK ao Projeto Selecionado .

Adicionar importa ou instrução do ao seu código.

using Microsoft.ConcurrencyVisualizer.Instrumentation;

Imports Microsoft.ConcurrencyVisualizer.Instrumentation

C++

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

Para adicionar suporte do SDK à projeto C++ ou C

Na barra de menus, escolha Analisar, Concurrency Visualizer, Adicionar SDK ao Projeto.
Selecione o projeto em que você deseja acessar o SDK e escolha o botão de Adicionar SDK ao Projeto Selecionado .
Para C++, inclua cvmarkersobj.h.Para C, inclua cvmarkers.h.
Adicionar uma instrução do ao seu código.
```
using namespace Concurrency::diagnostic;
```

Crie um objeto de marker_series e passá-lo para o construtor de span .

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

Use personalizado

Para cenários avançados, o visualizador SDK de simultaneidade expõe mais controle. Dois conceitos principais são associados aos cenários mais avançados: provedores de marcador e série de marcador.Os provedores de marcador é provedores diferentes do ETW (cada um tem o GUID diferente).As séries de marcador são canais consecutivas de eventos gerados por um provedor.Você pode usá-los para organizar os eventos gerados por um provedor de marcador.

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

Crie um objeto MarkerWriter. O construtor usa um GUID.
Para registrar o provedor, abra a caixa de diálogo de Configurações avançadas do visualizador de simultaneidade. Selecione a guia de Marcadores e escolha no botão de Adicionar novo provedor .Na caixa de diálogo de Configurações avançadas , insira o GUID que foi usada para criar o provedor e uma descrição do provedor.

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

Use a função de CvInitProvider para inicializar um PCV_PROVIDER. O construtor usa um GUID* e um PCV_PROVIDER*.
Para registrar o provedor, abra a caixa de diálogo de Configurações avançadas . Selecione a guia de Marcadores e escolha no botão de Adicionar novo provedor .Nesta caixa de diálogo, insira o GUID que foi usada para criar o provedor e uma descrição do provedor.

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

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

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

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

Para usar uma série de marcador em c projeto criando

Crie um objeto marker_series. Você pode gerar eventos dessa nova série.
```
marker_series series;
series.write_flag(_T("Hello world!"));
```

Para usar uma série de marcador em c projeto

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

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

Tópicos relacionados

Nome	Descrição
Referência de biblioteca C++	Descreve o visualizador API de simultaneidade para C++.
Referência de biblioteca C	Descreve o visualizador API de simultaneidade para C.
Microsoft.ConcurrencyVisualizer.Instrumentation	Descreve o visualizador API de simultaneidade para código gerenciado.
Visualizador de Simultaneidade	Informações de referência para as exibições e os relatórios de arquivos de dados de perfil que são gerados usando o método de simultaneidade e incluir dados de execução de thread.

Partilhar via