Share via


Método IDebugEventCallbacks::Breakpoint (dbgeng.h)

O método de retorno de chamada de ponto de interrupção é chamado pelo mecanismo quando o destino emite uma exceção de ponto de interrupção.

Sintaxe

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT Bp
);

Parâmetros

[in] Bp

Especifica um ponteiro para o objeto IDebugBreakpoint correspondente ao ponto de interrupção que foi disparado.

Retornar valor

Esse método retorna um valor DEBUG_STATUS_XXX , que indica como a execução do destino deve continuar após o mecanismo processar esse evento. Para obter detalhes sobre como o mecanismo trata esse valor, consulte Eventos de Monitoramento.

Comentários

Se o ponto de interrupção tiver um comando associado, o mecanismo executará esse comando antes de chamar esse método.

O mecanismo só chamará esse método se um objeto IDebugBreakpoint correspondente ao ponto de interrupção existir no mecanismo e, se o ponto de interrupção for um ponto de interrupção privado, esse objeto IDebugEventCallbacks foi registrado com o cliente que adicionou o ponto de interrupção.

O mecanismo chamará esse método somente se o sinalizador DEBUG_EVENT_BREAKPOINT estiver definido na máscara retornada por IDebugEventCallbacks::GetInterestMask.

Como o mecanismo exclui o objeto IDebugBreakpoint correspondente quando um ponto de interrupção é removido (por exemplo, usando RemoveBreakpoint), o valor de Bp pode ser inválido após o retorno do Ponto de Interrupção . Portanto, as implementações de IDebugEventCallbacks não devem acessar Bp após o retorno do ponto de interrupção.

Para obter mais informações sobre como lidar com eventos, consulte Eventos de monitoramento. Para obter informações sobre como gerenciar pontos de interrupção, consulte Pontos de interrupção.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)