Udostępnij za pośrednictwem


IDkmRuntimeMonitorBreakpointHandler.EnableRuntimeBreakpoint Method

Definition

Enables a breakpoint. Breakpoints start off initially disabled, so this method must be called before the breakpoint can be set. Enabling a breakpoint is typically implemented in the debug monitor by modifying the state of the target process. For example inserting an 'int3' instruction into the code stream. If the breakpoint is already enabled, this operation has no effect.

Once a breakpoint has been enabled, the debug monitor will raise a RuntimeBreakpoint event for this DkmRuntimeBreakpoint object whenever the trigger condition (ex: target instruction is executed) is met. Multiple DkmRuntimeBreakpoints may be set on the same instruction. In this case, the debug monitor will raise a different RuntimeBreakpoint event for each breakpoint object. Similarly, if a step complete and a breakpoint both complete on the same instruction, the debug monitor will raise both events.

public:
 void EnableRuntimeBreakpoint(Microsoft::VisualStudio::Debugger::Breakpoints::DkmRuntimeBreakpoint ^ runtimeBreakpoint);
public void EnableRuntimeBreakpoint (Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeBreakpoint runtimeBreakpoint);
abstract member EnableRuntimeBreakpoint : Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeBreakpoint -> unit
Public Sub EnableRuntimeBreakpoint (runtimeBreakpoint As DkmRuntimeBreakpoint)

Parameters

runtimeBreakpoint
DkmRuntimeBreakpoint

[In] Low-level breakpoint object which is supported by debug monitors.

Exceptions

E_RUNTIME_BREAKPOINT_ERROR indicates that an error has occurred in a monitor component while enabling the runtime breakpoint and that the monitor component has provided an error message via IDkmDataBreakpointErrorInfoClient.OnError.

Applies to