IDkmCompiledInspectionQueryProcessor.ExecuteQuery Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.ComponentInterfaces

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Executes a compiled inspection query and returns any results.

public:
 cli::array <Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILEvaluationResult ^> ^ ExecuteQuery(Microsoft::VisualStudio::Debugger::Evaluation::DkmCompiledInspectionQuery ^ query, System::Collections::ObjectModel::ReadOnlyCollection<Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILParameterValue ^> ^ parameters, Microsoft::VisualStudio::Debugger::Evaluation::DkmILContext ^ iLContext, System::UInt32 timeout, Microsoft::VisualStudio::Debugger::Evaluation::DkmFuncEvalFlags funcEvalFlags, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILFailureReason % failureReason);

public Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult[] ExecuteQuery (Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery query, System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILParameterValue> parameters, Microsoft.VisualStudio.Debugger.Evaluation.DkmILContext iLContext, uint timeout, Microsoft.VisualStudio.Debugger.Evaluation.DkmFuncEvalFlags funcEvalFlags, out Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILFailureReason failureReason);

abstract member ExecuteQuery : Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILParameterValue> * Microsoft.VisualStudio.Debugger.Evaluation.DkmILContext * uint32 * Microsoft.VisualStudio.Debugger.Evaluation.DkmFuncEvalFlags * DkmILFailureReason -> Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult[]

Public Function ExecuteQuery (query As DkmCompiledInspectionQuery, parameters As ReadOnlyCollection(Of DkmILParameterValue), iLContext As DkmILContext, timeout As UInteger, funcEvalFlags As DkmFuncEvalFlags, ByRef failureReason As DkmILFailureReason) As DkmILEvaluationResult()

Parameters

query

DkmCompiledInspectionQuery

[In] Represents a query which is produced by an expression evaluator or similar component and set to the target computer to obtain information about the dynamic state of the program (ex: the current value of a register). Consumers of inspection queries should call Close() once it is known that the inspection query will no longer execute.

parameters

ReadOnlyCollection<DkmILParameterValue>

[In,Optional] Optional array of parameter values to pass to the IL stream.

iLContext

DkmILContext

[In] The stack frame context we are evaluating on.

timeout

UInt32

[In] This is the timeout to be used for potentially slow operations such as a function evaluation. This value is in milliseconds.

funcEvalFlags

DkmFuncEvalFlags

[In] Flags impacting how function evaluation requests are performed.

failureReason

DkmILFailureReason

[Out] If an expected error occurs evaluating the DkmIL, indicates the reason for the failure.

Returns

DkmILEvaluationResult[]

[Out] Results of the evaluations. Each ILEvaluationResult object contains an index that indicates which DkmILInstruction in the instructions parameter this result came from. NOTE: some instructions will not return a result.