Controlar o alvo

Enquanto você estiver depurando um aplicativo de destino no modo usuário ou um computador de destino no modo kernel, o destino pode estar em execução ou interrompido.

Quando o depurador se conecta a um destino no modo kernel, o depurador deixa o destino em execução, a menos que você use a opção de linha de comando-b, o sistema de destino parou de responder (ou seja, falhou) ou o sistema de destino ainda será interrompido devido a uma ação de depuração de kernel anterior.

Quando o depurador inicia ou se conecta a um destino no modo de usuário, o depurador interrompe imediatamente o destino, a menos que você use a opção de linha de comando -g . Para obter mais informações, consulte Ponto de Interrupção Inicial.

Quando o alvo está em execução

Quando o alvo está em execução, a maioria das ações do depurador não está disponível.

Se você quiser parar um destino em execução, poderá emitir um comando Break . Esse comando faz com que o depurador interrompa o alvo. Ou seja, o depurador interrompe o alvo e todo o controle é transferido para o depurador. O aplicativo pode não ser interrompido imediatamente. Por exemplo, se todos os threads estiverem executando o código do sistema ou estiverem em uma operação de espera, o aplicativo será interrompido somente depois que o controle retornar ao código do aplicativo.

Se um alvo em execução encontrar uma exceção, se determinados eventos ocorrerem, se um ponto de interrupção for atingido, ou se o aplicativo for fechado normalmente, o alvo entra no depurador. Essa ação interrompe o alvo e dá todo o controle ao depurador. Uma mensagem aparece na janela Comando do Depurador e descreve o erro, o evento ou o ponto de interrupção.

Quando o alvo é interrompido

Para iniciar ou controlar a execução do alvo, você pode fazer o seguinte:

• Para fazer com que o aplicativo comece a ser executado, emita o comando Go .

• Para percorrer o aplicativo uma instrução de cada vez, use os comandos Step Into ou Step Over . Se ocorrer uma chamada de função, Step Into entrará na função e continuará percorrendo cada instrução. Step Over trata a chamada de função como uma única etapa. Quando o depurador está no modo de assembly, o avanço ocorre uma instrução de máquina por vez. Quando o depurador está no modo de origem, o avanço ocorre uma linha de código por vez.

• Para concluir a função atual e parar quando o retorno ocorrer, use os comandos Step Out ou Trace and Watch . O comando Step Out continua até que a função atual seja encerrada. Rastreamento e observação continuam até que a função atual termine e exibem um resumo das chamadas da função. No entanto, você deve emitir o comando Rastreamento e Inspeção na primeira instrução da função em questão.

• Se ocorrer uma exceção, você poderá usar os comandos Go with Exception Handled e Go with Exception Not Handled para retomar a execução e controlar o status da exceção. (Para obter mais informações sobre exceções, consulte Controlando exceções e eventos.)

• (Somente WinDbg) Se você selecionar uma linha na janela de desmontagem ou em uma janela de origem e, em seguida, usar o comando Executar até o Cursor, o programa será executado até encontrar a linha selecionada.

• (Somente modo de usuário) Para fechar o aplicativo de destino e reiniciá-lo desde o início, use o comando Reiniciar . Você pode usar este comando apenas com um processo que o depurador criou. Depois que o processo é reiniciado, ele entra imediatamente no depurador.

• (Somente WinDbg) Para fechar o aplicativo de destino e limpar o depurador, use o comando Parar Depuração . Esse comando permite que você inicie a depuração de um alvo diferente.

Formulários de Comando

A maioria dos comandos para iniciar ou controlar a execução do destino existe como comandos de texto, comandos de menu, botões da barra de ferramentas e teclas de atalho. Como comandos de texto básicos, você pode usar esses comandos em CDB, KD ou WinDbg. (A forma de texto dos comandos frequentemente dá suporte a opções adicionais, como alterar o local do contador do programa ou executar um número fixo de instruções.) Você pode usar os comandos de menu, botões da barra de ferramentas e teclas de atalho no WinDbg.

Você pode usar os comandos nos formulários a seguir.

Comando	Comando WinDbg	As teclas de atalho do WinDbg	Efeito
	Depuração | Executar até o cursor	F7 CTRL + F10	(Somente WinDbg) Executa até atingir a linha que o cursor marca.
	Depurar | Parar a depuração	SHIFT + F5	Interrompe toda a depuração e fecha o alvo.
(Somente CDB/KD) CTRL+C	Depuração | Interrupção	CTRL+BREAK	A execução é interrompida, e o depurador entra no alvo.
.restart (reiniciar aplicativo de destino)	Depuração | Reinício	CTRL + SHIFT + F5	(Somente modo de usuário) Reinicia o aplicativo de destino.
g (Go)	Depuração | Ir	F5	O alvo é executado livremente.
gc (continuar a partir do ponto de interrupção condicional)			Retoma a execução após um ponto de interrupção condicional.
gh (executar com exceção tratada)	Depuração | Exceção tratada ao ir		O mesmo que g (Go), exceto que a exceção atual é considerada tratada.
gn (executar com exceção não tratada)	Depuração | Exceção não tratada ao ir		O mesmo que g (Go), exceto que a exceção atual é tratada como não manipulada.
gu (Ir para cima)	Depuração | Sair	SHIFT + F11	O alvo é executado até que a função atual seja concluída.
p (Etapa)	Depuração | Passo a passo	F10	A Target executa uma instrução. Se essa instrução for uma chamada de função, essa função será executada como uma única etapa.
pa (etapa para o endereço)			O alvo é executado até alcançar o endereço especificado. Todas as etapas nessa função são exibidas (mas as etapas nas funções chamadas não são).
pc (etapa até a próxima chamada)			O destino é executado até a próxima instrução de chamada. Se a instrução atual for uma instrução de chamada , essa chamada será executada completamente e a execução continuará até a próxima chamada.
pct (Passo para a Próxima Chamada ou Retorno)			O alvo é executado até atingir uma instrução de chamada ou uma instrução de retorno.
ph (Avançar para a próxima instrução de desvio)			O alvo é executado até atingir qualquer tipo de instrução de ramificação, incluindo ramificações condicionais ou incondicionais, chamadas, retornos e chamadas do sistema.
pt (passo para o próximo retorno)			O alvo é executado até chegar a uma instrução de retorno.
t (Traço)	Depuração | Intervir	F11 F8	A Target executa uma instrução. Se esta instrução for uma chamada de função, o depurador rastreará essa chamada.
ta (rastreamento até o endereço)			O alvo é executado até alcançar o endereço especificado. Todas as etapas nesta função e nas funções chamadas são exibidas.
tb (rastreamento até a próxima ramificação)			(Todos os modos, exceto o modo kernel, somente em sistemas baseados em x86) O alvo é executado até chegar à próxima instrução de ramificação.
tc (rastreamento até a próxima chamada)			O destino é executado até a próxima instrução de chamada. Se a instrução atual for uma instrução de chamada , a instrução será rastreada até que uma nova chamada seja alcançada.
tct (rastreamento até a próxima chamada ou retorno)			O alvo é executado até atingir uma instrução de chamada ou uma instrução de retorno. Se a instrução atual for uma instrução de chamada ou de retorno, ela será rastreada até que uma nova chamada ou retorno seja alcançada.
th (rastreamento até a próxima instrução de ramificação)			O alvo é executado até atingir qualquer tipo de instrução de ramificação, incluindo ramificações condicionais ou incondicionais, chamadas, retornos e chamadas do sistema. Se a instrução atual for uma instrução de ramificação, a instrução será rastreada até que uma nova instrução de ramificação seja alcançada.
tt (rastreamento até o próximo retorno)			O alvo é executado até chegar a uma instrução de retorno. Se a instrução atual for uma instrução de retorno , a instrução será rastreada até que um novo retorno seja atingido.
wt (dados de rastreamento e monitoramento)			O alvo é executado até a conclusão de toda a função especificada. As estatísticas são exibidas em seguida.

Para obter mais informações sobre como reiniciar o computador de destino, consulte Falha e reinicialização do computador de destino.

Opções de Linha de Comando

Se você não quiser que o aplicativo pare imediatamente quando ele for iniciado ou carregado, use CDB ou WinDbg junto com a opção de linha de comando -g . Para obter mais informações sobre essa situação, consulte Ponto de Interrupção Inicial.

CDB e WinDbg também dão suporte à opção de linha de comando-G. Essa opção faz com que a sessão de depuração termine se o aplicativo for executado sem erros.

O comando a seguir tenta executar o aplicativo do início ao fim e o prompt do depurador é exibido somente se ocorrer um erro.

cdb -g -G ApplicationName 

Você pode usar a opção de linha de comando -pt para definir o tempo limite de interrupção. Há certos problemas que podem impedir que o alvo se comunique com o depurador. Se um comando de interrupção for emitido e o depurador não puder interromper o alvo após esse tempo, o depurador exibirá uma mensagem "Tempo limite para interrupção".

Neste ponto, o depurador para de tentar acessar o alvo. Em vez disso, o debugger pausa o alvo e permite que você examine (mas não controle) o aplicativo alvo.

O tempo limite padrão é de 30 segundos.