IDkmRuntimeMonitorBreakpointHandler.EnableRuntimeBreakpoint Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> unitPublic 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.