Udostępnij za pośrednictwem

DkmNativeInstructionSymbol.GetSteppingRanges Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualStudio.Debugger.Native
Zestaw:
Microsoft.VisualStudio.Debugger.Engine.dll
Pakiet:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Przeciążenia

GetSteppingRanges(DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean)

Wysyła zapytanie do dostawcy symboli, aby określić zakresy instrukcji, które podstawowy monitor debugowania powinien przejść w celu zaimplementowania kroku.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetSteppingRanges(DkmWorkList, DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean, DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>)

Wysyła zapytanie do dostawcy symboli, aby określić zakresy instrukcji, które podstawowy monitor debugowania powinien przejść w celu zaimplementowania kroku.

Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę uzupełniania.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetSteppingRanges(DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean)

Wysyła zapytanie do dostawcy symboli, aby określić zakresy instrukcji, które podstawowy monitor debugowania powinien przejść w celu zaimplementowania kroku.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

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()

Parametry

ModuleInstance
DkmModuleInstance

[W] Wystąpienie modułu zawierające bieżący symbol instrukcji.

StepStartingAddress
DkmInstructionAddress

[In,Optional] Instrukcja, w której rozpoczął się krok. Może mieć wartość null w nietypowych sytuacjach, takich jak rozpoczęcie kroku bez ramek na stosie. Należy pamiętać, że nie jest to instrukcja natywna.

RangeBoundary
DkmSteppingRangeBoundary

[W] Wskazuje dostawcy symboli typ instrukcji do uwzględnienia w regionach "bez kroku".

IncludeInline
Boolean

[W] Wartość True, jeśli dostawca symboli powinien zatrzymać zakres krokowy w przypadku napotkania funkcji wbudowanych. W przeciwnym razie wartość false. Natywna funkcja DM przekaże wartość true dla kroku, więc kroki przestaną działać w funkcjach wbudowanych. Będzie ona przekazywana wartość false podczas wykonywania krokowego, więc krok krok nie zostanie zatrzymany w funkcjach wbudowanych.

Zwraca

DkmSteppingRange[]

[Out] Tablica zakresów do przejścia. Ta tablica będzie pusta, jeśli nie ma informacji o źródle dla danej instrukcji.

Dotyczy

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

Wysyła zapytanie do dostawcy symboli, aby określić zakresy instrukcji, które podstawowy monitor debugowania powinien przejść w celu zaimplementowania kroku.

Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę uzupełniania.

Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000).

Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

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))

Parametry

WorkList
DkmWorkList

WorkList, aby dołączyć nowy element roboczy do.

ModuleInstance
DkmModuleInstance

[W] Wystąpienie modułu zawierające bieżący symbol instrukcji.

StepStartingAddress
DkmInstructionAddress

[In,Optional] Instrukcja, w której rozpoczął się krok. Może mieć wartość null w nietypowych sytuacjach, takich jak rozpoczęcie kroku bez ramek na stosie. Należy pamiętać, że nie jest to instrukcja natywna.

RangeBoundary
DkmSteppingRangeBoundary

[W] Wskazuje dostawcy symboli typ instrukcji do uwzględnienia w regionach "bez kroku".

IncludeInline
Boolean

[W] Wartość True, jeśli dostawca symboli powinien zatrzymać zakres krokowy w przypadku napotkania funkcji wbudowanych. W przeciwnym razie wartość false. Natywna funkcja DM przekaże wartość true dla kroku, więc kroki przestaną działać w funkcjach wbudowanych. Będzie ona przekazywana wartość false podczas wykonywania krokowego, więc krok krok nie zostanie zatrzymany w funkcjach wbudowanych.

CompletionRoutine
DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>

Procedura uruchamiania po zakończeniu żądania. Jeśli żądanie zostanie pomyślnie dołączone do listy roboczej, zawsze zostanie to uruchomione (w tym po anulowaniu operacji). Nigdy nie zostanie wyzwolony w przypadku niepowodzenia dołączania elementu roboczego.

Dotyczy