Visualizador de simultaneidade SDK

Artigo
02/25/2013

Você pode instrumentar o código-fonte usando o SDK do Visualizador de simultaneidade para exibir informações adicionais no Visualizador de simultaneidade.Você pode associar dados adicionais com fases e eventos em seu código.Essas visualizações adicionais são conhecidas como marcadores.Para uma explicação introdutória, consulte apresentando o SDK do Visualizador de simultaneidade.

Propriedades

Sinalizadores, spans e mensagens ter duas propriedades: categoria e importância.No Configurações avançadas caixa de diálogo, você pode usar essas propriedades para filtrar o conjunto de marcadores são exibidos.Além disso, essas propriedades afetam a representação visual dos marcadores.Por exemplo, o tamanho de sinalizadores é usado 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á está registrado com o Visualizador de simultaneidade e você não precisa fazer nada para fazer os marcadores são exibidos na interface do usuário.

C# e Visual Basic

No C#, Visual basic e outro código gerenciado, use o provedor padrão chamando Markers.Ele expõe quatro funções 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 tem um parâmetro de seqüência de caracteres que especifica a descrição do evento.A descrição é exibida nos relatórios do Visualizador de simultaneidade.

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

Na barra de menu, escolha Analisar, Visualizador de simultaneidade, SDK adicionar ao projeto.
Selecione o projeto no qual você deseja acessar o SDK e escolha o SDK adicionar ao projeto selecionado botão.

Adicione um imports ou using instrução no seu código.

using Microsoft.ConcurrencyVisualizer.Instrumentation;

Imports Microsoft.ConcurrencyVisualizer.Instrumentation

C++

No C++, criar um Classe marker_series de objeto e usá-lo para chamar funções.O 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_messagee o Método marker_series::write_alert.

Para adicionar suporte a SDK para um projeto de C++ ou c

Na barra de menu, escolha Analisar, Visualizador de simultaneidade, SDK adicionar ao projeto.
Selecione o projeto no qual você deseja acessar o SDK e escolha o SDK adicionar ao projeto selecionado botão.
Para C++, incluem cvmarkersobj.h.Para C, inclua cvmarkers.h.
Adicionar um usando instrução no seu código.
```
using namespace Concurrency::diagnostic;
```

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

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

Uso personalizado

Para cenários avançados, o SDK do Visualizador de simultaneidade expõe mais controle.Dois conceitos principais estão associados com cenários mais avançados: provedores de marcador e série de marcador.Provedores de marcador são diferentes provedores ETW (cada um tem um GUID diferente).Série de marcador é canais seriais de eventos gerados por um provedor.Você pode usá-las para organizar os eventos gerados por um provedor de marcador.

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

Crie um objeto MarkerWriter.O construtor obtém um GUID.
Para registrar o provedor, abra o Visualizador de simultaneidade Configurações avançadas caixa de diálogo.Selecione o marcadores guia e escolha o Adicionar novo provedor de botão.No Configurações avançadas caixa de diálogo, digite o GUID usado para criar o provedor e uma descrição do provedor.

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

Use o CvInitProvider função para inicializar um PCV_PROVIDER.O construtor obtém um GUID * e PCV_PROVIDER *.
Para registrar o provedor, abra o Configurações avançadas caixa de diálogo.Selecione o marcadores guia e escolha o Adicionar novo provedor de botão.Na 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 marcador em um projeto de C# ou Visual Basic

Para usar um novo MarkerSeries, primeiro a criar usando um MarkerWriter de objeto e gerar 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 um projeto de C++

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

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

Use o CvCreateMarkerSeries função 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 da biblioteca C++	Descreve o visualisador de simultaneidade API para C++.
Referência de biblioteca c	Descreve o visualisador de simultaneidade API para c.
Microsoft.ConcurrencyVisualizer.Instrumentation	Descreve a API de Visualizador de simultaneidade para código gerenciado.
Visualizador de simultaneidade	Informações de referência para os modos de exibição e relatórios de arquivos de dados que são gerados usando o método de simultaneidade e que incluem dados de execução do thread de criação de perfil.

Compartilhar via