Depuração de código-fonte no WinDbg (clássico)

Caminho de Origem

O caminho de origem especifica os diretórios em que os arquivos de origem C e C++ estão localizados. Para obter mais informações sobre como exibir o código-fonte no depurador, consulte Caminho do código-fonte.

Nota Se você estiver conectado a uma rede corporativa, a maneira mais eficiente de acessar arquivos de origem será usar um servidor de origem. Você pode usar um servidor de origem usando a cadeia de caracteres srv* no caminho de origem. Para obter mais informações sobre servidores de origem, consulte Usando um servidor de origem.

Para controlar o caminho de origem no WinDbg, siga um destes procedimentos:

• Escolha Caminho do Arquivo de Origem no menu Arquivo ou pressione CTRL+P.

• Use o comando .srcpath (Definir caminho de origem). Se você estiver usando um servidor de origem, .srcfix (Usar Servidor de Origem) será um pouco mais fácil.

• Use o comando .lsrcpath (Definir caminho de origem local). Se você estiver usando um servidor de origem, .lsrcfix (Usar Servidor de Origem Local) será um pouco mais fácil.

• Ao iniciar o depurador, use a opção de linha de comando -srcpath ou -lsrcpath . Consulte Opções de Command-Line do WinDbg.

• Antes de iniciar o depurador, defina a variável de ambiente _NT_SOURCE_PATH.

Abrindo e fechando arquivos de origem

Para abrir ou fechar um arquivo de origem diretamente, siga um destes procedimentos:

• Escolha Arquivo de Código Aberto no menu Arquivo ou pressione CTRL+O. Você também pode usar o botão Arquivo de software livre (

  Nota Quando você usa o menu ou o botão da barra de ferramentas para abrir um arquivo de origem, o caminho desse arquivo é acrescentado automaticamente ao caminho de origem.

• Escolha Fechar Janela Atual no menu Arquivo .

• Selecione o botão Fechar no canto da janela Origem.

• Escolha Arquivos Recentes no menu Arquivo para abrir um dos quatro arquivos de origem que você abriu mais recentemente no WinDbg.

• Insira o comando .open (Arquivo de Software Livre).

• Insira o comando lsf (Carregar ou Descarregar Arquivo de Origem).

No WinDbg, a janela Origem exibe arquivos de origem que foram carregados no depurador.

Abrindo a janela de origem

O depurador abre uma janela de origem quando carrega um novo arquivo de origem. Para restaurar ou alternar para uma janela open Source, vá para o menu Janela e escolha na lista de janelas na parte inferior do menu.

A captura de tela a seguir mostra um exemplo de uma janela Origem.

Cada arquivo de origem reside em sua própria janela Origem. O título de cada janela Origem é o caminho completo do arquivo de origem.

Usando a janela de origem

Cada janela Origem exibe o texto de um arquivo de origem. Não é possível editar um arquivo de origem no depurador. Para obter mais informações sobre como alterar as configurações de fonte e guia, consulte Alterando propriedades de texto.

Cada janela Origem tem um menu de atalho com comandos adicionais. Para acessar o menu, selecione e segure (ou clique com o botão direito do mouse) na barra de título ou selecione o ícone que aparece próximo ao canto superior direito da janela. A lista a seguir descreve alguns dos comandos de menu:

• Definir o ponteiro de instrução para a linha atual altera o valor do ponteiro de instrução para a instrução que corresponde à linha atual. Esse comando é equivalente ao uso de Editar | Defina o comando Instrução Atual ou pressione CTRL+SHIFT+I.

• Editar esse arquivo abre o arquivo de origem em um editor de texto. O editor é determinado pelas informações do registro do editor WinDiff ou pelo valor da variável de ambiente WINDBG_INVOKE_EDITOR. Por exemplo, considere o caso quando o valor de WINDBG_INVOKE_EDITOR for o seguinte.

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

  Nesse caso, Myeditor.exe será aberto para o número de linha baseado em um do arquivo de origem atual. A opção %l indica que os números de linha devem ser lidos como baseados em um, enquanto %f indica que o arquivo de origem atual deve ser usado. Outras possibilidades de substituição incluem %L, que indica que os números de linha são baseados em zero e %p, o que também pode indicar que o arquivo de origem atual deve ser usado.

• Avaliar a seleção avalia o texto selecionado no momento usando o avaliador de expressão C++. O resultado aparece na janela Comando do Depurador. Se o texto selecionado incluir mais de uma linha, um erro de sintaxe resultará. Esse comando é equivalente ao uso de Editar | Avaliar o comando Seleção , pressionar CTRL+SHIFT+V ou usar o ?? (Avaliar expressão C++) comando com o texto selecionado como seu argumento.

• Exibir o tipo selecionado exibe o tipo de dados do objeto selecionado. Essa exibição é exibida na janela Comando do Depurador. Se o texto selecionado incluir mais de um único objeto, um erro de sintaxe ou outros resultados irregulares poderão ser exibidos. Esse comando é equivalente ao uso de Editar | Exiba o comando Tipo Selecionado ou pressione CTRL+SHIFT+Y.

• A janela Abrir memória para seleção abre uma nova janela Memória encaixada que exibe memória começando no endereço da expressão selecionada.

• Adicionar seleção à janela Inspeção acrescenta o token de origem selecionado à janela Inspeção.

• Desmontar na linha atual faz com que a instrução que corresponde à linha atual apareça na janela Desmontagem. A linha selecionada está realçada na janela Origem e na janela Desmontagem, mas esse comando afeta apenas a exibição — o ponteiro de instrução não é alterado. Se a janela Desmontar for fechada quando esse comando for selecionado, ela será aberta.

• Selecionar idioma de origem exibe uma lista de linguagens de programação. Selecione a linguagem de programação que você usou para gerar o arquivo de origem e selecione OK para habilitar o realce de sintaxe básica para a janela Origem atual. Selecione <Nenhum> para desabilitar o realce da sintaxe para a janela Origem atual.

Cores da janela de origem e avaliação de foco

Se o depurador reconhecer a extensão de nome do arquivo de origem, a janela Origem exibirá determinados elementos de sintaxe em cores. Para desativar ou alterar as cores, faça o seguinte:

• Para desativar as cores da sintaxe em uma única janela, abra o menu de atalho da janela Origem, selecione Selecionar idioma de origem e selecione <Nenhum>.

• Para desativar as cores da sintaxe para todas as janelas de origem, escolha Opções no menu Exibir . Em seguida, desmarque a caixa Marcar Idiomas de Origem de Análise.

• Para alterar as cores da sintaxe, escolha Opções no menu Exibir . Em seguida, na área Cores , selecione um elemento de sintaxe e selecione o botão Alterar para alterar a cor.

• O método de análise usado para o realce é determinado pela linguagem de programação associada à extensão de arquivo para o arquivo de origem. Para alterar a linguagem de programação associada a uma extensão de arquivo específica, use a caixa de diálogo Extensões de Arquivo para Idiomas de Origem. Para abrir essa caixa de diálogo, escolha Extensões de arquivo de idioma de origem no menu Exibir .

A linha que representa o contador do programa atual está realçada. As linhas nas quais os pontos de interrupção são definidos também são realçadas.

Se você selecionar uma janela Origem e usar o mouse para passar o mouse sobre um símbolo nessa janela, o símbolo será avaliado. A avaliação é a mesma produzida pelo comando dt (Tipo de Exibição). Para desativar essa avaliação, escolha Opções no menu Exibir . Em seguida, desmarque a caixa Avaliar marcar focalizar.

Confira também

Para obter mais informações sobre depuração de origem e comandos relacionados, consulte Depuração no Modo de Origem.