DkmCompiledInspectionQuery.Execute Method

Definition

Overloads

Execute(ReadOnlyCollection<DkmILParameterValue>, DkmILContext, UInt32, DkmFuncEvalFlags, DkmILFailureReason)

Executes a compiled inspection query and returns any results.

Execute(DkmWorkList, ReadOnlyCollection<DkmILParameterValue>, DkmILContext, UInt32, DkmFuncEvalFlags, DkmCompletionRoutine<DkmExecuteQueryAsyncResult>)

Executes a compiled inspection query and returns any results.

This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.

Execute(ReadOnlyCollection<DkmILParameterValue>, DkmILContext, UInt32, DkmFuncEvalFlags, DkmILFailureReason)

Executes a compiled inspection query and returns any results.

public:
 cli::array <Microsoft::VisualStudio::Debugger::Evaluation::IL::DkmILEvaluationResult ^> ^ Execute(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[] Execute (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);
public Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILEvaluationResult[] Execute (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);
member this.Execute : 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 Execute (Parameters As ReadOnlyCollection(Of DkmILParameterValue), ILContext As DkmILContext, Timeout As UInteger, FuncEvalFlags As DkmFuncEvalFlags, ByRef FailureReason As DkmILFailureReason) As DkmILEvaluationResult()

Parameters

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

[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.

Applies to

Execute(DkmWorkList, ReadOnlyCollection<DkmILParameterValue>, DkmILContext, UInt32, DkmFuncEvalFlags, DkmCompletionRoutine<DkmExecuteQueryAsyncResult>)

Executes a compiled inspection query and returns any results.

This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.

public:
 void Execute(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, 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, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Evaluation::DkmExecuteQueryAsyncResult> ^ CompletionRoutine);
public void Execute (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, 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, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Evaluation.DkmExecuteQueryAsyncResult> CompletionRoutine);
public void Execute (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, 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, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Evaluation.DkmExecuteQueryAsyncResult> CompletionRoutine);
member this.Execute : Microsoft.VisualStudio.Debugger.DkmWorkList * System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.VisualStudio.Debugger.Evaluation.IL.DkmILParameterValue> * Microsoft.VisualStudio.Debugger.Evaluation.DkmILContext * uint32 * Microsoft.VisualStudio.Debugger.Evaluation.DkmFuncEvalFlags * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Evaluation.DkmExecuteQueryAsyncResult> -> unit
Public Sub Execute (WorkList As DkmWorkList, Parameters As ReadOnlyCollection(Of DkmILParameterValue), ILContext As DkmILContext, Timeout As UInteger, FuncEvalFlags As DkmFuncEvalFlags, CompletionRoutine As DkmCompletionRoutine(Of DkmExecuteQueryAsyncResult))

Parameters

WorkList
DkmWorkList

WorkList to append the new work item to.

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.

CompletionRoutine
DkmCompletionRoutine<DkmExecuteQueryAsyncResult>

Routine to fire when the request is complete. If the request is successfully appended to the work list, this will always fire (including when the operation is canceled). This will never fire if appending the work item fails.

Applies to