IDkmLanguageExpressionCompiler.CompileCondition Method

Definition

Compiles an input breakpoint condition into an inspection query which can be evaluated on the target computer. 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.

public:
 Microsoft::VisualStudio::Debugger::Evaluation::DkmCompiledInspectionQuery ^ CompileCondition(Microsoft::VisualStudio::Debugger::Evaluation::DkmLanguageInstructionAddress ^ languageInstructionAddress, Microsoft::VisualStudio::Debugger::Breakpoints::DkmBreakpointCondition ^ condition, [Runtime::InteropServices::Out] System::String ^ % errorText);
public Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery CompileCondition (Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguageInstructionAddress languageInstructionAddress, Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointCondition condition, out string errorText);
abstract member CompileCondition : Microsoft.VisualStudio.Debugger.Evaluation.DkmLanguageInstructionAddress * Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointCondition * string -> Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery
Public Function CompileCondition (languageInstructionAddress As DkmLanguageInstructionAddress, condition As DkmBreakpointCondition, ByRef errorText As String) As DkmCompiledInspectionQuery

Parameters

languageInstructionAddress
DkmLanguageInstructionAddress

[In] Pairing between an instruction address and the language that should be used to decode it.

condition
DkmBreakpointCondition

[In] Breakpoint condition to compile.

errorText
String

[Out,Optional] If the compilation failed, this indicates the reason why. This value should be null if the compile succeeded. If the compile does fail, S_FALSE is returned (native code only).

Returns

[Out,Optional] The result of the compilation. This is null in the case that the compilation failed. In this case, ErrorText should indicate the reason for the failure.

Applies to