DkmCompiledInspectionQuery.Execute Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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);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);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> -> unitPublic 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.