Debug del codice sorgente in WinDbg (versione classica)

Percorso di origine

Il percorso di origine specifica le directory in cui si trovano i file di origine C e C++. Per altre informazioni sulla visualizzazione del codice sorgente nel debugger, vedere Percorso di origine.

Nota Se si è connessi a una rete aziendale, il modo più efficiente per accedere ai file di origine consiste nell'usare un server di origine. È possibile usare un server di origine usando la stringa srv* all'interno del percorso di origine. Per altre informazioni sui server di origine, vedere Uso di un server di origine.

Per controllare il percorso di origine in WinDbg, eseguire una delle operazioni seguenti:

• Scegliere Percorso file di origine dal menu File o premere CTRL+P.

• Usare il comando .srcpath (Set Source Path). Se si usa un server di origine, .srcfix (Usa server di origine) è leggermente più semplice.

• Usare il comando .lsrcpath (Imposta percorso origine locale). Se si usa un server di origine, .lsrcfix (Usa server di origine locale) è leggermente più semplice.

• Quando si avvia il debugger, usare l'opzione della riga di comando -srcpath o -lsrcpath . Consultare Opzioni Command-Line WinDbg.

• Prima di avviare il debugger, impostare la variabile di ambiente _NT_SOURCE_PATH.

Apertura e chiusura di file di origine

Per aprire o chiudere direttamente un file di origine, eseguire una delle operazioni seguenti:

• Scegliere Apri file sorgente dal menu File oppure premere CTRL+O. È anche possibile usare il pulsante Open source file (

  Nota Quando si usa il menu o il pulsante della barra degli strumenti per aprire un file di origine, il percorso del file viene aggiunto automaticamente al percorso di origine.

• Scegliere Chiudi finestra corrente dal menu File .

• Selezionare il pulsante Chiudi nell'angolo della finestra Origine.

• Scegliere File recenti dal menu File per aprire uno dei quattro file di origine aperti più di recente in WinDbg.

• Immettere il comando .open (Open Source File).

• Immettere il comando lsf (Carica o Scarica file di origine).

In WinDbg la finestra Origine visualizza i file di origine caricati nel debugger.

Apertura della finestra di origine

Il debugger apre una finestra di origine quando carica un nuovo file di origine. Per ripristinare o passare a una finestra open Source, passare al menu Finestra e scegliere dall'elenco delle finestre nella parte inferiore del menu.

La schermata seguente mostra un esempio di finestra Origine.

Ogni file di origine si trova nella propria finestra di origine. Il titolo di ogni finestra origine è il percorso completo del file di origine.

Uso della finestra di origine

Ogni finestra Origine visualizza il testo di un file di origine. Non è possibile modificare un file di origine nel debugger. Per altre informazioni sulla modifica delle impostazioni del tipo di carattere e della scheda, vedere Modifica delle proprietà del testo.

Ogni finestra della sorgente include un menu di scelta rapida con comandi aggiuntivi. Per accedere al menu, selezionare e tenere premuto (o fare clic con il pulsante destro del mouse) sulla barra del titolo o selezionare l'icona visualizzata accanto all'angolo superiore destro della finestra. L'elenco seguente descrive alcuni dei comandi di menu:

• Impostare il puntatore dell'istruzione sulla riga corrente modifica il valore del puntatore dell'istruzione all'istruzione corrispondente alla riga corrente. Questo comando equivale all'uso di Edit | Imposta istruzione corrente o premere CTRL+MAIUSC+I.

• Modificare questo file apre il file di origine in un editor di testo. L'editor è determinato dalle informazioni del Registro di sistema dell'editor WinDiff o dal valore della variabile di ambiente WINDBG_INVOKE_EDITOR. Si consideri ad esempio il caso in cui il valore di WINDBG_INVOKE_EDITOR è il seguente.

  c:\my\path\myeditor.exe -file %f -line %l
  

  In questo caso, Myeditor.exe aprirà il file di origine corrente alla riga numerata a partire da uno. L'opzione %l indica che i numeri di riga devono essere letti a base uno, mentre %f indica che si dovrebbe usare il file di origine corrente. Altre possibilità di sostituzione includono %L, che indica che i numeri di riga sono in base zero e %p, che può anche indicare che il file di origine corrente deve essere usato.

• Valuta la selezione valuta il testo attualmente selezionato usando l'analizzatore di espressioni C++. Il risultato viene visualizzato nella finestra Di comando del debugger. Se il testo selezionato include più righe, viene restituito un errore di sintassi. Questo comando equivale all'uso di Edit | Comando Valuta selezione , premendo CTRL+MAIUSC+V o usando ?? (Valuta espressione C++) comando con il testo selezionato come argomento.

• Visualizza il tipo selezionato visualizza il tipo di dati dell'oggetto selezionato. Questa visualizzazione viene visualizzata nella finestra Di comando del debugger. Se il testo selezionato include più di un singolo oggetto, potrebbe essere visualizzato un errore di sintassi o altri risultati irregolari. Questo comando equivale all'uso del comando Edit | Visualizza tipo selezionato o premere CTRL+MAIUSC+Y.

• Apre la finestra memoria per la selezione apre una nuova finestra Memoria ancorata che visualizza la memoria a partire dall'indirizzo dell'espressione selezionata.

• Aggiungi selezione alla finestra Osserva appende il token di origine selezionato alla finestra Osserva.

• Disassemble alla riga corrente fa apparire l'istruzione corrispondente alla riga attuale nella finestra Disassembly. La riga selezionata è evidenziata nella finestra Origine e nella finestra Disassembly, ma questo comando influisce solo sulla visualizzazione, ovvero il puntatore all'istruzione non viene modificato. Se la finestra Disassembly è chiusa quando questo comando è selezionato, viene aperta.

• Selezionare il linguaggio di origine visualizza un elenco di linguaggi di programmazione. Selezionare il linguaggio di programmazione usato per generare il file di origine e quindi selezionare OK per abilitare l'evidenziazione della sintassi di base per la finestra Origine corrente. Selezionare <Nessuno per disabilitare> l'evidenziazione della sintassi per la finestra Origine corrente.

Finestra sorgente: colori e valutazione al passaggio del mouse

Se il debugger riconosce l'estensione del nome file di origine, nella finestra Origine vengono visualizzati determinati elementi della sintassi a colori. Per disattivare o modificare i colori, eseguire le operazioni seguenti:

• Per disattivare i colori della sintassi in una singola finestra, aprire il menu di scelta rapida della finestra di origine, selezionare Seleziona lingua di origine e quindi selezionare<> Nessuno.

• Per disattivare i colori della sintassi per tutte le finestre Origine, scegliere Opzioni dal menu Visualizza . Deselezionare quindi la casella di controllo Analizza lingue origine .

• Per modificare i colori della sintassi, scegliere Opzioni dal menu Visualizza . Nell'area Colori selezionare quindi un elemento della sintassi e selezionare il pulsante Cambia per modificare il colore.

• Il metodo di analisi utilizzato per l'evidenziazione è determinato dal linguaggio di programmazione associato all'estensione di file per il file di origine. Per modificare il linguaggio di programmazione associato a un'estensione di file specifica, usare la finestra di dialogo Estensioni file per i linguaggi di origine. Per aprire questa finestra di dialogo, scegliere Estensioni del file di linguaggio di origine dal menu Visualizza .

La riga che rappresenta il contatore del programma corrente è evidenziata. Vengono evidenziate anche le righe in corrispondenza delle quali vengono impostati punti di interruzione.

Se si seleziona una finestra di origine e quindi si usa il mouse per passare il puntatore del mouse su un simbolo in tale finestra, il simbolo verrà valutato. La valutazione è identica a quella prodotta dal comando dt (Tipo di visualizzazione). Per disattivare questa valutazione, scegliere Opzioni dal menu Visualizza . Deselezionare quindi la casella di controllo Valuta al passaggio del mouse .

Vedere anche

Per altre informazioni sul debug dell'origine e sui comandi correlati, vedere Debug in modalità origine.