Share via

IDkmRuntimeStepper.StepControlRequested Method

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Debugger.ComponentInterfaces
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Package:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

StepControlRequested is called by the stepping manager when a non-controlling runtime instance detects that the thread has hit a transition into its runtime. If the current controlling runtime instance can stop stepping, it should set Granted to true. Actual control is not given until the requesting runtime calls DkmStepper.TakeStepControl. This two part process allows callers to request control of multiple steppers at the same time.

public:
 bool StepControlRequested(Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ runtimeInstance, Microsoft::VisualStudio::Debugger::Stepping::DkmStepper ^ stepper, Microsoft::VisualStudio::Debugger::Stepping::DkmStepArbitrationReason reason, Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ callingRuntimeInstance);
public bool StepControlRequested (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance runtimeInstance, Microsoft.VisualStudio.Debugger.Stepping.DkmStepper stepper, Microsoft.VisualStudio.Debugger.Stepping.DkmStepArbitrationReason reason, Microsoft.VisualStudio.Debugger.DkmRuntimeInstance callingRuntimeInstance);
abstract member StepControlRequested : Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Microsoft.VisualStudio.Debugger.Stepping.DkmStepper * Microsoft.VisualStudio.Debugger.Stepping.DkmStepArbitrationReason * Microsoft.VisualStudio.Debugger.DkmRuntimeInstance -> bool
Public Function StepControlRequested (runtimeInstance As DkmRuntimeInstance, stepper As DkmStepper, reason As DkmStepArbitrationReason, callingRuntimeInstance As DkmRuntimeInstance) As Boolean

Parameters

runtimeInstance
DkmRuntimeInstance

[In] The DkmRuntimeInstance class represents an execution environment which is loaded into a DkmProcess and which contains code to be debugged.

stepper
DkmStepper

[In] DkmStepper represents a request to step a thread. It facilitates shared object lifetime between the various runtime debug monitors that participate in stepping.

reason
DkmStepArbitrationReason

[In] DkmStepArbitrationReason the reason step arbitration is occurring.

callingRuntimeInstance
DkmRuntimeInstance

[In] The calling runtime instance that wishes to take control of the step.

Returns

Boolean

[Out] The controlling runtime can stop the step and give control to the caller, then it should set this to true.

Applies to