Condividi tramite

Suggerimenti per il debug dei thread

Questo articolo fornisce informazioni utili per il debug dei thread, incluse informazioni sull'impostazione dei nomi di thread per il codice nativo e gestito.

Suggerimenti per C/C++

Ecco alcuni suggerimenti che è possibile usare durante il debug dei thread nel codice nativo:

  • È possibile visualizzare il contenuto del blocco delle informazioni del thread digitando @TIB nella finestra di Osservazione o nella finestra di dialogo Osservazione immediata.

  • È possibile visualizzare l'ultimo codice di errore per il thread corrente inserendo @Err nella finestra Watch o nella finestra di dialogo QuickWatch.

  • Le funzioni C Run-Time Libraries (CRT) possono essere utili per il debug di un'applicazione multithreading. Per altre informazioni, vedere _malloc_dbg.

Impostare un nome di thread in C/C++

La denominazione dei thread è possibile in qualsiasi edizione di Visual Studio. La denominazione dei thread è utile per identificare i thread di interesse nella finestra Thread durante il debug di un processo in esecuzione. La presenza di thread con nomi riconoscibili può essere utile anche quando si esegue il debug post-mortem tramite l'ispezione dei dump di arresto anomalo del sistema e quando si analizzano le prestazioni attraverso vari strumenti.

Modi per impostare un nome di thread

Esistono due modi per impostare un nome di thread. Il primo è tramite la funzione SetThreadDescription . Il secondo consiste nel generare una particolare eccezione mentre il debugger di Visual Studio è collegato al processo. Ogni approccio presenta vantaggi e avvertenze. L'uso di SetThreadDescription è supportato a partire da Windows 10 versione 1607 o Windows Server 2016.

Vale la pena notare che entrambi gli approcci possono essere usati insieme, se necessario, poiché i meccanismi in base ai quali funzionano sono indipendenti l'uno dall'altro.

Impostare un nome di thread usando SetThreadDescription

Vantaggi:

  • I nomi dei thread sono visibili durante il debug in Visual Studio, indipendentemente dal fatto che il debugger sia stato collegato al processo al momento in cui viene richiamato SetThreadDescription.
  • I nomi dei thread sono visibili quando si esegue il debug post-mortem caricando un dump di crash in Visual Studio.
  • I nomi dei thread sono visibili anche quando si usano altri strumenti, ad esempio il debugger WinDbg e l'analizzatore delle prestazioni di Windows Performance Analyzer .

Avvertenze:

  • I nomi dei thread sono visibili solo in Visual Studio 2017 versione 15.6 e versioni successive.
  • Quando si esegue il debug di un file dump di arresto anomalo del sistema, i nomi dei thread sono visibili solo se l'arresto anomalo è stato creato in Windows 10 versione 1607, Windows Server 2016 o versioni successive di Windows.

Esempio:

#include <windows.h>
#include <processthreadsapi.h>

int main()
{
    HRESULT r;
    r = SetThreadDescription(
        GetCurrentThread(),
        L"ThisIsMyThreadName!"
    );

    return 0;
}

Impostare un nome di thread generando un'eccezione

Un altro modo per impostare un nome di thread nel programma consiste nel comunicare il nome del thread desiderato al debugger di Visual Studio generando un'eccezione configurata appositamente.

Vantaggi:

  • Funziona in tutte le versioni di Visual Studio.

Avvertenze:

  • Funziona solo se il debugger è collegato al momento dell'utilizzo del metodo basato su eccezioni.
  • I nomi dei thread impostati tramite questo metodo non saranno disponibili nei dump o negli strumenti di analisi delle prestazioni.

Esempio:

La SetThreadName funzione illustrata di seguito illustra questo approccio basato su eccezioni. Si noti che il nome del thread verrà copiato automaticamente nel thread, in modo che la memoria per il threadName parametro possa essere rilasciata dopo il completamento della SetThreadName chiamata.

//
// Usage: SetThreadName ((DWORD)-1, "MainThread");
//
#include <windows.h>
const DWORD MS_VC_EXCEPTION = 0x406D1388;
#pragma pack(push,8)
typedef struct tagTHREADNAME_INFO
{
    DWORD dwType; // Must be 0x1000.
    LPCSTR szName; // Pointer to name (in user addr space).
    DWORD dwThreadID; // Thread ID (-1=caller thread).
    DWORD dwFlags; // Reserved for future use, must be zero.
} THREADNAME_INFO;
#pragma pack(pop)
void SetThreadName(DWORD dwThreadID, const char* threadName) {
    THREADNAME_INFO info;
    info.dwType = 0x1000;
    info.szName = threadName;
    info.dwThreadID = dwThreadID;
    info.dwFlags = 0;
#pragma warning(push)
#pragma warning(disable: 6320 6322)
    __try{
        RaiseException(MS_VC_EXCEPTION, 0, sizeof(info) / sizeof(ULONG_PTR), (ULONG_PTR*)&info);
    }
    __except (EXCEPTION_EXECUTE_HANDLER){
    }
#pragma warning(pop)
}

Impostare un nome di thread nel codice gestito

La denominazione dei thread è possibile in qualsiasi edizione di Visual Studio. La denominazione dei thread è utile per tenere traccia dei thread nella finestra Thread .

Per impostare un nome di thread nel codice gestito, usare la Name proprietà .

Example

public class Needle
{
    // This method will be called when the thread is started.
    public void Baz()
    {
        Console.WriteLine("Needle Baz is running on another thread");
    }
}

public void Main()
{
    Console.WriteLine("Thread Simple Sample");
    Needle oNeedle = new Needle();
    // Create a Thread object.
    System.Threading.Thread oThread = new System.Threading.Thread(oNeedle.Baz);
    // Set the Thread name to "MyThread".
    oThread.Name = "MyThread";
    // Starting the thread invokes the ThreadStart delegate
    oThread.Start();
}

Contenuti correlati

  • Last updated on