SDK del visualizzatore di concorrenza

Articolo
03/05/2013

È possibile modificare il codice sorgente utilizzando l'SDK del Visualizzatore di concorrenza per visualizzare informazioni aggiuntive nel Visualizzatore di concorrenza.È possibile associare dati aggiuntivi alle fasi e agli eventi nel codice.Queste visualizzazioni aggiuntive sono note come marcatori.Per una dettagliata procedura introduttiva, vedere Introduzione all'SDK del Visualizzatore di concorrenza.

Proprietà

Le flag, gli intervalli e i messaggi dispongono di due proprietà: categoria e priorità.Nella finestra di dialogo Impostazioni avanzate, è possibile utilizzare queste proprietà per filtrare l'insieme di marcatori visualizzato.Inoltre, queste proprietà influiscono sulla rappresentazione visiva dei marcatori.Ad esempio, la dimensione delle flag viene utilizzata per rappresentare la priorità.Inoltre, il colore viene utilizzato per indicare la categoria.

Utilizzo di base

Il Visualizzatore di concorrenza espone un provider predefinito che si può utilizzare per generare i marcatori.Il provider è già registrato con il Visualizzatore di concorrenza e non è necessario eseguire alcuna operazione per far apparire i marcatori all'interno dell'interfaccia utente.

C# e Visual Basic

In C#, Visual Basic e altro codice gestito, viene utilizzato il provider predefinito chiamando Markers.Esso espone quattro funzioni per la generazione dei marcatori: WriteFlag, EnterSpan, WriteMessage e WriteAlert.Esistono overload multipli per queste funzioni, a seconda che si desiderino utilizzare le impostazioni predefinite per le proprietà.L'overload più semplice accetta un solo parametro di tipo stringa che specifica la descrizione dell'evento.La descrizione viene visualizzata nei report del Visualizzatore di concorrenza.

Per aggiungere il supporto all'SDK ad un progetto C# o Visual Basic

Sulla barra dei menù, scegliere Analizza, Visualizzatore di concorrenza, Aggiungi SDK al progetto.
Selezionare il progetto in cui si desidera accedere all'SDK quindi premere il pulsante Aggiungi SDK al progetto selezionato.

Aggiungere le importazioni oppure le istruzioni using al codice.

using Microsoft.ConcurrencyVisualizer.Instrumentation;

Imports Microsoft.ConcurrencyVisualizer.Instrumentation

C++

In C++, creare un oggetto Classe marker_series e utilizzarlo per chiamare le funzioni.La classe marker_series espone tre funzioni per la generazione dei marcatori, Metodo marker_series::write_flag, Metodo marker_series::write_message e Metodo marker_series::write_alert.

Per aggiungere il supporto all'SDK ad un progetto C++ o C

Sulla barra dei menù, scegliere Analizza, Visualizzatore di concorrenza, Aggiungi SDK al progetto.
Selezionare il progetto in cui si desidera accedere all'SDK quindi premere il pulsante Aggiungi SDK al progetto selezionato.
Per C++, includere cvmarkersobj.h.Per C, includere cvmarkers.h.

Aggiungere un'istruzione using al codice.

using namespace Concurrency::diagnostic;

Creare un nuovo oggetto marker_series e passarlo al costruttore di span.
```
marker_series mySeries;
span s(mySeries, _T("Span description"));
```

Utilizzo Personalizzato

Per scenari avanzati, l'SDK del Visualizzatore di concorrenza espone un maggiore controllo.Due concetti principali sono associati a scenari più avanzati: provider di marcatori e serie di marcatori.I provider di marcatori sono dei provider ETW diversi (ognuno con un GUID diverso).Le serie di marcatori sono canali seriali di eventi generati da un provider.È possibile utilizzarli per organizzare gli eventi generati da un provider di marcatori.

Per utilizzare un nuovo provider di marcatori in un progetto C# o Visual Basic.

Creare un oggetto MarkerWriter.Il costruttore accetta un GUID.
Per registrare il provider, aprire la finestra di dialogo Impostazioni avanzate del Visualizzatore di concorrenza.Selezionare la scheda Marcatori quindi premere il pulsante Aggiungi nuovo provider.Nella finestra di dialogo Impostazioni avanzate, immettere il GUID utilizzato per creare il provider e una descrizione del provider.

Per utilizzare un nuovo provider di marcatori in un progetto C++ o C

Utilizzare la funzione CvInitProvider per inizializzare un PCV_PROVIDER.Il costruttore accetta un GUID* ed un PCV_PROVIDER*.
Per registrare il provider, aprire la finestra di dialogo Impostazioni avanzate.Selezionare la scheda Marcatori quindi premere il pulsante Aggiungi nuovo provider.In questa finestra di dialogo, immettere il GUID utilizzato per creare il provider e una descrizione del provider.

Per utilizzare una serie di marcatori in un progetto C# o Visual Basic

Per utilizzare una nuova MarkerSeries, prima crearla utilizzando un oggetto MarkerWriter e quindi generare gli eventi del marcatore direttamente dalla nuova serie.

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

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

Per utilizzare una serie di marcatori in un progetto C++

Creare un oggetto marker_series.È possibile generare eventi da questa nuova serie.
```
marker_series series;
series.write_flag(_T("Hello world!"));
```

Per utilizzare una serie di marcatori in un progetto C

Utilizzare la funzione CvCreateMarkerSeries per creare un PCV_MARKERSERIES.

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

Argomenti correlati

Titolo	Descrizione
Riferimento alla libreria C++	Descrive l'API del Visualizzatore di concorrenza per C++.
Riferimento alla libreria C	Descrive l'API del Visualizzatore di concorrenza per C.
Microsoft.ConcurrencyVisualizer.Instrumentation	Descrive l'API del Visualizzatore di concorrenza per il codice gestito.
Visualizzatore di concorrenze	Informazioni di riferimento relative a visualizzazioni e rapporti dei file di dati di profilatura generati tramite il metodo di concorrenza e che includono di dati di esecuzione di thread.

Condividi tramite