Definindo pontos de interrupção

Os pontos de interrupção são criados com o método AddBreakpoint . Esse método cria um objeto IDebugBreakpoint que representa o ponto de interrupção. Ele também define o tipo de ponto de interrupção (ponto de interrupção do software ou ponto de interrupção do processador). Uma vez que um ponto de interrupção tenha sido criado, seu tipo não pode ser alterado.

Os pontos de interrupção são excluídos com o método RemoveBreakpoint . Isso também exclui o objeto IDebugBreakpoint ; Este objeto não pode ser usado novamente.

Observação Embora IDebugBreakpoint implemente a interface IUnknown , os métodos IUnknown::AddRef e IUnknown::Release não são usados para controlar o tempo de vida do ponto de interrupção. Estes métodos não têm qualquer efeito sobre a durabilidade do ponto de interrupção. Em vez disso, um objeto IDebugBreakpoint é excluído depois que o método RemoveBreakpoint é chamado.

Quando o ponto de interrupção é criado, ele recebe uma ID de ponto de interrupção exclusiva. Este identificador não será alterado. No entanto, depois de o ponto de interrupção ter sido eliminado, o seu identificador poderá ser usado para outro ponto de interrupção. Para obter detalhes sobre como receber notificação da remoção de um ponto de interrupção, consulte Monitorando eventos.

Quando um ponto de interrupção é criado, ele é inicialmente desativado; Isso significa que isso não fará com que o alvo pare de executar. Esse ponto de interrupção pode ser habilitado usando o método AddFlags para adicionar o sinalizador DEBUG_BREAKPOINT_ENABLED.

Quando um ponto de interrupção é criado pela primeira vez, ele tem o local da memória 0x00000000 associado a ele. O local pode ser alterado usando SetOffset com um endereço ou usando SetOffsetExpression com uma expressão simbólica. A localização do ponto de interrupção deve ser alterada em relação ao seu valor inicial antes de ser usada.