SDK del Visualizador de simultaneidad

Se puede instrumentar el código fuente mediante el SDK del Visualizador de simultaneidad para mostrar información adicional en el Visualizador de simultaneidad.Se pueden asociar los datos adicionales con fases y eventos del código.Estas visualizaciones adicionales se conocen como marcadores.Para un tutorial introductorio, consulte Introducción al SDK del Visualizador de Simultaneidad.

Propiedades

Los indicadores, los periodos y los mensajes tienen dos propiedades: categoría e importancia.En el cuadro de diálogo Configuración avanzada, se pueden usar estas propiedades para filtrar el conjunto de marcadores que aparecen.Además, estas propiedades afectan a la representación visual de los marcadores.Por ejemplo, el tamaño de los indicadores se usa para representar la importancia.Asimismo, el color se usa para indicar la categoría.

Uso básico

El Visualizador de simultaneidad expone un proveedor predeterminado que se puede utilizar para generar marcadores.El proveedor ya está registrado junto con el Visualizador de simultaneidad y no se tiene que hacer nada más para conseguir que los marcadores aparezcan en la interfaz de usuario.

Visual Basic y C#

En C#, Visual basic y otro código administrado, use el proveedor predeterminado llamando a Markers.Expone cuatro funciones para generar marcadores: WriteFlag, EnterSpan, WriteMessage y WriteAlert.Hay múltiples sobrecargas para estas funciones, según se quieran usar los predeterminados para estas propiedades.La sobrecarga más simple toma sólo un parámetro de cadena que especifica la descripción del evento.Se muestra la descripción en los informes del Visualizador de simultaneidad.

Para agregar soporte SDK al proyecto de C# o de Visual Basic

1. En la barra de menú, elija Analizar, Visualizador de Simultaneidad, Agregar SDK al proyecto.

2. Seleccione el proyecto en el que se quiere acceder al SDK y luego elija el botón Agregar SDK al proyecto seleccionado.

3. Agregar e importar o usar sentencias en el código.

   using Microsoft.ConcurrencyVisualizer.Instrumentation;
   

   Imports Microsoft.ConcurrencyVisualizer.Instrumentation
   

C++

En C++, cree un objeto marker_series (Clase) y utilícelo para llamar funciones.La clase marker_series expones tres funciones para generar marcadores, el marker_series::write_flag (Método), el marker_series::write_message (Método) y el marker_series::write_alert (Método).

Para agregar soporte SDK al proyecto de C++ o C

1. En la barra de menú, elija Analizar, Visualizador de Simultaneidad, Agregar SDK al proyecto.

2. Seleccione el proyecto en el que se quiere tener acceso al SDK y después elija el botón Agregar SDK al proyecto sleccionado.

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

4. Agregar una instrucción using al código.

   using namespace Concurrency::diagnostic;
   

5. Cree un objeto marker_series y páseselo al constructor span.

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

Uso personalizado

En escenarios avanzados, el SDK del Visualizador de simultaneidad expone más control.Dos conceptos principales se asocian con escenarios más avanzados: los proveedores de marcadores y las series de marcadores.Los proveedores de marcadores son diferentes de los proveedores ETW (cada uno tiene una GUID diferente).Las series de marcadores son canales de serie de eventos que son generados por un proveedor.Estos se pueden utilizar para organizar los eventos que son generados por un proveedor de marcadores.

Para usar un nuevo proveedor de marcadores en un proyecto de C# o de Visual Basic

1. Crear un objeto MarkerWriter.El constructor toma una GUID.

2. Para registrar el proveedor, abra el cuadro de diálogo del Visualizador de Simultaneidad Configuración avanzada.Seleccione la pestaña Marcadores y luego elija el botón Agregar nuevo proveedor.En el cuadro de diálogo Configuración avanzada, escriba la GUID que se usó para crear el proveedor y una descripción del proveedor.

Para utilizar un nuevo proveedor de marcadores en un proyecto de C++ o C.

1. Utilice la función CvInitProvider para inicializar un PROVEEDOR PCV.El constructor toma una GUID* y un PROVEEDOR PCV*

2. Para registrar el proveedor, abra el cuadro de diálogo Configuración avanzada.Seleccione la pestaña Marcadores y luego elija el botón Agregar nuevo proveedor.En esta cuadro de diálogo, escriba el GUID que se utilizó para crear el proveedor y una descripción del proveedor.

Para usar una serie de marcador en un proyecto de C# o de Visual Basic.

• Para utilizar un nuevo MarkerSeries, primero créelo mediante un objeto MarkerWriter y luego genere marcadores de eventos directamente desde la nueva serie.

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

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

Para usar una serie de marcador en un proyecto de C++

• Crear un objeto marker_series.Se pueden generar eventos desde esta nueva serie.

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

Para utilizar una serie de marcador en un proyecto de C

• Use la función CvCreateMarkerSeries para crear un PCV_MARKERSERIES.

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

Temas relacionados

Título	Descripción
Referencia de la biblioteca C++	Describe la API del Visualizador de simultaneidad para C++
Referencia de la biblioteca C	Describe la API del Visualizador de simultaneidad para C.
Microsoft.ConcurrencyVisualizer.Instrumentation	Describe la API del Visualizador de simultaneidad para código administrado.
Visualizador de simultaneidad	Información de referencia para las vistas y los informes de archivos de datos de generación de perfiles que se generan mediante el método de simultaneidad e incluyen datos de ejecución de subprocesos.