Compartilhar via


DkmEvaluationBreakpointCondition Class

Definition

Represents a condition which is evaluated on the target computer. These objects are used for languages where the expression evaluator is implemented on the target.

public ref class DkmEvaluationBreakpointCondition : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable
[System.Runtime.InteropServices.Guid("d838eb1d-9ec7-751c-1896-5057bf597376")]
public class DkmEvaluationBreakpointCondition : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable
[<System.Runtime.InteropServices.Guid("d838eb1d-9ec7-751c-1896-5057bf597376")>]
type DkmEvaluationBreakpointCondition = class
    inherit DkmDataContainer
    interface IDisposable
Public Class DkmEvaluationBreakpointCondition
Inherits DkmDataContainer
Implements IDisposable
Inheritance
DkmEvaluationBreakpointCondition
Inheritance
DkmEvaluationBreakpointCondition
Attributes
Implements

Properties

IsUnloaded

Returns true if a 'unloaded' event has been raised for this object (example: DkmThread::Unload is called) or if the object has been closed. Note that care must be used when checking this status as, without synchronization, the returned status may no longer be accurate the instruction after it is read.

(Inherited from DkmDataContainer)
Language

Language used to parse the condition.

RuntimeBreakpoint

Runtime breakpoint that this condition is used on.

RuntimeInstance

The DkmRuntimeInstance class represents an execution environment which is loaded into a DkmProcess and which contains code to be debugged.

Source

The breakpoint condition which is evaluated.

UniqueId

Guid which uniquely identifies this condition object.

Methods

Close()

Closes a DkmEvaluationBreakpointCondition object instance. This will release any resources associated with this object across all components. This includes resources across computer or managed/native marshalling boundaries.

DkmEvaluationBreakpointCondition objects are automatically closed when their associated DkmRuntimeBreakpoint object is closed.

This method may only be called by the component which created the object.

Location constraint: API must be called from a Monitor component (component level < 100,000).

Create(DkmRuntimeBreakpoint, DkmBreakpointCondition, DkmLanguage, DkmDataItem)

Create a new DkmEvaluationBreakpointCondition object instance. The caller is responsible for closing the created object after they are done.

Location constraint: API must be called from a Monitor component (component level < 100,000).

Evaluate(DkmStackWalkFrame, Boolean, String)

Evaluates a condition to decide if the debugger should stop.

Location constraint: API must be called from a Monitor component (component level < 100,000).

GetDataItem<T>()

Gets the instance of 'T' which has been added to this container instance. If this container does not contain a 'T', this function will return null.

(Inherited from DkmDataContainer)
Parse(String)

Parses an input breakpoint condition so that it can later be evaluated. If the breakpoint condition uses DkmBreakpointConditionOperator.BreakWhenTrue, the expression evaluator should require that the specified condition evaluates to a Boolean value. The created query must return only a single result. For BreakWhenTrue conditions, this must be either a 4-byte or 1-byte value, and any non-zero value is considered true.

Location constraint: API must be called from a Monitor component (component level < 100,000).

RemoveDataItem<T>()

Remove the instance of 'T' from this container. It is usually unnecessary to call this method as a data container will automatically be emptied when the object is closed.

(Inherited from DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Place a new item in the data container.

(Inherited from DkmDataContainer)

Explicit Interface Implementations

IDisposable.Dispose()

Applies to