IDkmBaseFuncEvalService.BeginFuncEvalExecution Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.ComponentInterfaces

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

This method is used to resume the target process so that a function evaluation may occur. This function is called by a runtime debug monitor after it has setup a function evaluation in order to make the target process run. The runtime monitor will first update the thread context, update any necessary memory in the target process, and setup any detection that the function evaluation is completed.

Callers of this method MUST always call EndFuncEvalExecution before returning from the operation that triggered the function evaluation. The behavior is undefined if a caller fails to do so.

This method is implemented in the base debug monitor by first updating the target process to be in function evaluation mode (DkmThread.OnBeginFuncEvalExecution), then suspending and/or resuming threads as specified by the function evaluation flags and finally continuing the target process.

This method may be called from any thread, however OnBeginFuncEvalExecution must be called from the stopping event thread, so the base debug monitor may need to perform as thread switch as part of the implementation of this method. The base debug monitor should not return from BeginFuncEvalExecution until after the target has been resumed.

public:
 void BeginFuncEvalExecution(Microsoft::VisualStudio::Debugger::DkmThread ^ thread, Microsoft::VisualStudio::Debugger::Evaluation::DkmFuncEvalFlags flags);

public void BeginFuncEvalExecution (Microsoft.VisualStudio.Debugger.DkmThread thread, Microsoft.VisualStudio.Debugger.Evaluation.DkmFuncEvalFlags flags);

abstract member BeginFuncEvalExecution : Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.Evaluation.DkmFuncEvalFlags -> unit

Public Sub BeginFuncEvalExecution (thread As DkmThread, flags As DkmFuncEvalFlags)

Parameters

thread

DkmThread

[In] DkmThread represents a thread running in the target process.

flags

DkmFuncEvalFlags

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