Partilhar via


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:

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 (Captura de tela do botão Arquivo de Software Livre no WinDbg.

    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.

Captura de tela da janela Origem no WinDbg, exibindo um arquivo de origem carregado.

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.