IDkmBreakpointConditionProcessor Interface

Definition

Namespace:

Microsoft.VisualStudio.Debugger.ComponentInterfaces

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Interface implemented on the target computer to handle evaluating breakpoint conditions and hit counts.

Implementations of this interface may restrict when they are called using a filter defined in their component configuration. The following properties may be used: BaseDebugMonitorId, EngineId, RuntimeId, SourceId.

public interface class IDkmBreakpointConditionProcessor

public interface class IDkmBreakpointConditionProcessor

__interface IDkmBreakpointConditionProcessor

public interface IDkmBreakpointConditionProcessor

type IDkmBreakpointConditionProcessor = interface

Public Interface IDkmBreakpointConditionProcessor

Methods

ClearConditions(DkmRuntimeBreakpoint)	Clear any compiled/evaluation condition associated with the specified DkmRuntimeBreakpoint. This method is implicitly called when the DkmRuntimeBreakpoint is closed.
ClearHitCountCondition(DkmRuntimeBreakpoint, DkmBreakpointHitCountCondition, Int32)	Clears the hit count condition on a breakpoint.
GetHitCountConditionStatus(DkmRuntimeBreakpoint, Int32)	Obtains the current hit count value for a DkmRuntimeBreakpoint which has a hit count condition. This function will fail if the DkmRuntimeBreakpoint does not currently have a hit count condition.
SetCompiledCondition(DkmRuntimeInstructionBreakpoint, DkmCompiledInspectionQuery, DkmBreakpointConditionOperator)	This sets an associated compiled condition on the specified runtime instruction breakpoint. The breakpoint condition processor will then test the condition whenever it is hit. This is used for languages which are evaluated in the IDE process (ex: C++).
SetCompiledConditionPending(DkmRuntimeBreakpoint)	This method is similar to SetCompiledCondition, but is used in cases where the instruction address is not known up front, such as data breakpoints. In these cases, when the breakpoint is first hit at a particular address, a call will be made to the breakpoint client to obtain a new compiled condition for this address (IDkmBreakpointConditionProcessorClient.GetCompiledCondition). This is used for languages which are evaluated in the IDE process (ex: C++).
SetEvaluationCondition(DkmRuntimeBreakpoint, DkmBreakpointCondition, String)	Sets a breakpoint condition which is evaluated on the target computer. This is used for .NET languages.
SetHitCountCondition(DkmRuntimeBreakpoint, DkmBreakpointHitCountCondition, Int32)	Initialize or update the hit count condition/value on a breakpoint. If the same breakpoint has both a language-level condition, and a hit count condition, the language-level condition is applied first. The condition is implicitly removed if the DkmRuntimeBreakpoint is closed.