Freigeben über

DkmNativeInstructionSymbol.GetSteppingRanges Methode

  • Referenz

Definition

Namespace:
Microsoft.VisualStudio.Debugger.Native
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Paket:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Überlädt

GetSteppingRanges(DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean)

Fragt den Symbolanbieter ab, um die Anweisungen zu ermitteln, die der Basisdebugmonitor schrittweise durchlaufen soll, um einen Schritt zu implementieren.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.
GetSteppingRanges(DkmWorkList, DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean, DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>)

Fragt den Symbolanbieter ab, um die Anweisungen zu ermitteln, die der Basisdebugmonitor schrittweise durchlaufen soll, um einen Schritt zu implementieren.

Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.

GetSteppingRanges(DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean)

Fragt den Symbolanbieter ab, um die Anweisungen zu ermitteln, die der Basisdebugmonitor schrittweise durchlaufen soll, um einen Schritt zu implementieren.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.

public:
 cli::array <Microsoft::VisualStudio::Debugger::Symbols::DkmSteppingRange> ^ GetSteppingRanges(Microsoft::VisualStudio::Debugger::DkmModuleInstance ^ ModuleInstance, Microsoft::VisualStudio::Debugger::DkmInstructionAddress ^ StepStartingAddress, Microsoft::VisualStudio::Debugger::Symbols::DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline);
public Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRange[] GetSteppingRanges (Microsoft.VisualStudio.Debugger.DkmModuleInstance ModuleInstance, Microsoft.VisualStudio.Debugger.DkmInstructionAddress StepStartingAddress, Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline);
public Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRange[] GetSteppingRanges (Microsoft.VisualStudio.Debugger.DkmModuleInstance ModuleInstance, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? StepStartingAddress, Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline);
override this.GetSteppingRanges : Microsoft.VisualStudio.Debugger.DkmModuleInstance * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary * bool -> Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRange[]
Public Function GetSteppingRanges (ModuleInstance As DkmModuleInstance, StepStartingAddress As DkmInstructionAddress, RangeBoundary As DkmSteppingRangeBoundary, IncludeInline As Boolean) As DkmSteppingRange()

Parameter

ModuleInstance
DkmModuleInstance

[In] Modul instance, das das aktuelle Befehlssymbol enthält.

StepStartingAddress
DkmInstructionAddress

[In,Optional] Anweisung, an der der Schritt begann. Kann in ungewöhnlichen Situationen null sein, z. B. wenn der Schritt ohne Frames im Stapel beginnt. Beachten Sie, dass dies nicht unbedingt eine native Anweisung ist.

RangeBoundary
DkmSteppingRangeBoundary

[In] Gibt dem Symbolanbieter den Typ der Anweisungen an, die in die "No-Step"-Regionen eingeschlossen werden sollen.

IncludeInline
Boolean

[In] True, wenn der Symbolanbieter den Schrittbereich beenden soll, wenn eine Inlinefunktion angezeigt wird. Andernfalls FALSE. Native DM wird für einen Schritt true übergeben, sodass Die Schritte in Inlinefunktionen beendet werden. Bei einem Schrittüberlauf wird false übergeben, sodass der Schritt nicht in Inlinefunktionen angehalten wird.

Gibt zurück

DkmSteppingRange[]

[Out] Array von Bereichen, durch die schrittschritten werden soll. Dieses Array ist leer, wenn keine Quellinformationen für die angegebene Anweisung vorhanden sind.

Gilt für:

GetSteppingRanges(DkmWorkList, DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean, DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>)

Fragt den Symbolanbieter ab, um die Anweisungen zu ermitteln, die der Basisdebugmonitor schrittweise durchlaufen soll, um einen Schritt zu implementieren.

Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Diese API wurde in Visual Studio 14 RTM (DkmApiVersion.VS14RTM) eingeführt.

public void GetSteppingRanges (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.DkmModuleInstance ModuleInstance, Microsoft.VisualStudio.Debugger.DkmInstructionAddress? StepStartingAddress, Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Symbols.DkmGetSteppingRangesAsyncResult> CompletionRoutine);
override this.GetSteppingRanges : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.DkmModuleInstance * Microsoft.VisualStudio.Debugger.DkmInstructionAddress * Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary * bool * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Symbols.DkmGetSteppingRangesAsyncResult> -> unit
Public Sub GetSteppingRanges (WorkList As DkmWorkList, ModuleInstance As DkmModuleInstance, StepStartingAddress As DkmInstructionAddress, RangeBoundary As DkmSteppingRangeBoundary, IncludeInline As Boolean, CompletionRoutine As DkmCompletionRoutine(Of DkmGetSteppingRangesAsyncResult))

Parameter

WorkList
DkmWorkList

WorkList, an die das neue Arbeitselement angefügt werden soll.

ModuleInstance
DkmModuleInstance

[In] Modul instance, das das aktuelle Befehlssymbol enthält.

StepStartingAddress
DkmInstructionAddress

[In,Optional] Anweisung, an der der Schritt begann. Kann in ungewöhnlichen Situationen null sein, z. B. wenn der Schritt ohne Frames im Stapel beginnt. Beachten Sie, dass dies nicht unbedingt eine native Anweisung ist.

RangeBoundary
DkmSteppingRangeBoundary

[In] Gibt dem Symbolanbieter den Typ der Anweisungen an, die in die "No-Step"-Regionen eingeschlossen werden sollen.

IncludeInline
Boolean

[In] True, wenn der Symbolanbieter den Schrittbereich beenden soll, wenn eine Inlinefunktion angezeigt wird. Andernfalls FALSE. Native DM wird für einen Schritt true übergeben, sodass Die Schritte in Inlinefunktionen beendet werden. Bei einem Schrittüberlauf wird false übergeben, sodass der Schritt nicht in Inlinefunktionen angehalten wird.

CompletionRoutine
DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>

Routine, die ausgelöst wird, wenn die Anforderung abgeschlossen ist. Wenn die Anforderung erfolgreich an die Arbeitsliste angefügt wurde, wird diese immer ausgelöst (auch wenn der Vorgang abgebrochen wird). Dies wird nie ausgelöst, wenn beim Anfügen des Arbeitselements ein Fehler auftritt.

Gilt für: