DkmRuntimeBreakpoint.Enable Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.