DkmRuntimeBreakpoint.Enable Método

Definição

Sobrecargas

Enable(DkmWorkList, DkmCompletionRoutine<DkmEnableRuntimeBreakpointAsyncResult>)

Habilita um ponto de interrupção. Os pontos de interrupção começam a ser desabilitados inicialmente, portanto, esse método deve ser chamado antes que o ponto de interrupção possa ser definido. A habilitação de um ponto de interrupção normalmente é implementada no monitor de depuração modificando o estado do processo de destino. Por exemplo, inserir uma instrução ' Int3 ' no fluxo de código. Se o ponto de interrupção já estiver habilitado, essa operação não terá efeito.

Depois que um ponto de interrupção tiver sido habilitado, o monitor de depuração gerará um evento RuntimeBreakpoint para esse objeto DkmRuntimeBreakpoint sempre que a condição de gatilho (ex.: instrução de destino for executada) for atendida. Vários DkmRuntimeBreakpoints podem ser definidos na mesma instrução. Nesse caso, o monitor de depuração irá gerar um evento RuntimeBreakpoint diferente para cada objeto de ponto de interrupção. Da mesma forma, se uma etapa for concluída e um ponto de interrupção for concluído na mesma instrução, o monitor de depuração irá disparar ambos os eventos.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Esse método só pode ser chamado pelo componente que criou o objeto.

Enable()

Habilita um ponto de interrupção. Os pontos de interrupção começam a ser desabilitados inicialmente, portanto, esse método deve ser chamado antes que o ponto de interrupção possa ser definido. A habilitação de um ponto de interrupção normalmente é implementada no monitor de depuração modificando o estado do processo de destino. Por exemplo, inserir uma instrução ' Int3 ' no fluxo de código. Se o ponto de interrupção já estiver habilitado, essa operação não terá efeito.

Depois que um ponto de interrupção tiver sido habilitado, o monitor de depuração gerará um evento RuntimeBreakpoint para esse objeto DkmRuntimeBreakpoint sempre que a condição de gatilho (ex.: instrução de destino for executada) for atendida. Vários DkmRuntimeBreakpoints podem ser definidos na mesma instrução. Nesse caso, o monitor de depuração irá gerar um evento RuntimeBreakpoint diferente para cada objeto de ponto de interrupção. Da mesma forma, se uma etapa for concluída e um ponto de interrupção for concluído na mesma instrução, o monitor de depuração irá disparar ambos os eventos.

Esse método só pode ser chamado pelo componente que criou o objeto.

Enable(DkmWorkList, DkmCompletionRoutine<DkmEnableRuntimeBreakpointAsyncResult>)

Habilita um ponto de interrupção. Os pontos de interrupção começam a ser desabilitados inicialmente, portanto, esse método deve ser chamado antes que o ponto de interrupção possa ser definido. A habilitação de um ponto de interrupção normalmente é implementada no monitor de depuração modificando o estado do processo de destino. Por exemplo, inserir uma instrução ' Int3 ' no fluxo de código. Se o ponto de interrupção já estiver habilitado, essa operação não terá efeito.

Depois que um ponto de interrupção tiver sido habilitado, o monitor de depuração gerará um evento RuntimeBreakpoint para esse objeto DkmRuntimeBreakpoint sempre que a condição de gatilho (ex.: instrução de destino for executada) for atendida. Vários DkmRuntimeBreakpoints podem ser definidos na mesma instrução. Nesse caso, o monitor de depuração irá gerar um evento RuntimeBreakpoint diferente para cada objeto de ponto de interrupção. Da mesma forma, se uma etapa for concluída e um ponto de interrupção for concluído na mesma instrução, o monitor de depuração irá disparar ambos os eventos.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Esse método só pode ser chamado pelo componente que criou o objeto.

public:
 void Enable(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Breakpoints::DkmEnableRuntimeBreakpointAsyncResult> ^ CompletionRoutine);
public void Enable (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmEnableRuntimeBreakpointAsyncResult> CompletionRoutine);
member this.Enable : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmEnableRuntimeBreakpointAsyncResult> -> unit
Public Sub Enable (WorkList As DkmWorkList, CompletionRoutine As DkmCompletionRoutine(Of DkmEnableRuntimeBreakpointAsyncResult))

Parâmetros

WorkList
DkmWorkList

A tabela de trabalho à qual anexar o novo item de trabalho.

CompletionRoutine
DkmCompletionRoutine<DkmEnableRuntimeBreakpointAsyncResult>

Rotina a ser acionada quando a solicitação for concluída. Se a solicitação for acrescentada com êxito à lista de trabalho, isso sempre será acionado (incluindo quando a operação é cancelada). Isso nunca será acionado se a anexação do item de trabalho falhar.

Aplica-se a

Enable()

Habilita um ponto de interrupção. Os pontos de interrupção começam a ser desabilitados inicialmente, portanto, esse método deve ser chamado antes que o ponto de interrupção possa ser definido. A habilitação de um ponto de interrupção normalmente é implementada no monitor de depuração modificando o estado do processo de destino. Por exemplo, inserir uma instrução ' Int3 ' no fluxo de código. Se o ponto de interrupção já estiver habilitado, essa operação não terá efeito.

Depois que um ponto de interrupção tiver sido habilitado, o monitor de depuração gerará um evento RuntimeBreakpoint para esse objeto DkmRuntimeBreakpoint sempre que a condição de gatilho (ex.: instrução de destino for executada) for atendida. Vários DkmRuntimeBreakpoints podem ser definidos na mesma instrução. Nesse caso, o monitor de depuração irá gerar um evento RuntimeBreakpoint diferente para cada objeto de ponto de interrupção. Da mesma forma, se uma etapa for concluída e um ponto de interrupção for concluído na mesma instrução, o monitor de depuração irá disparar ambos os eventos.

Esse método só pode ser chamado pelo componente que criou o objeto.

public:
 void Enable();
public:
 void Enable();
void Enable();
public void Enable ();
member this.Enable : unit -> unit
Public Sub Enable ()

Exceções

E_RUNTIME_BREAKPOINT_ERROR indica que ocorreu um erro em um componente de monitor ao habilitar o ponto de interrupção de tempo de execução e que o componente de monitor forneceu uma mensagem de erro por meio de IDkmDataBreakpointErrorInfoClient. OnError.

Aplica-se a