DkmNativeInstructionSymbol.GetSteppingRanges 方法

參考

定義

命名空間:: Microsoft.VisualStudio.Debugger.Native

組件:: Microsoft.VisualStudio.Debugger.Engine.dll

套件:: Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

GetSteppingRanges(DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean)

查詢符號提供者，以判斷基底偵錯監視器應該逐步執行以實作步驟的指示範圍。

位置條件約束：必須從監視元件呼叫 API， (元件層級 < 100,000) 。

此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。

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

查詢符號提供者，以判斷基底偵錯監視器應該逐步執行以實作步驟的指示範圍。

這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回。工作項目的實際處理是異步的。呼叫端將會透過完成例程收到要求完成的通知。

位置條件約束：必須從監視元件呼叫 API， (元件層級 < 100,000) 。

此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。

GetSteppingRanges(DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean)

查詢符號提供者，以判斷基底偵錯監視器應該逐步執行以實作步驟的指示範圍。

位置條件約束：必須從監視元件呼叫 API， (元件層級 < 100,000) 。

此 API 是在 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()

參數

ModuleInstance: DkmModuleInstance

[In]包含目前指令符號的模組實例。

StepStartingAddress: DkmInstructionAddress

[In，Optional]步驟開始位置的指示。在不尋常的情況下，可能是 Null，例如在堆疊上沒有畫面格的情況下開始步驟。請注意，這不一定是原生指令。

RangeBoundary: DkmSteppingRangeBoundary

[In]向符號提供者指出要包含在「無步驟」區域中的指示類型。

IncludeInline: Boolean

[In]如果符號提供者在遇到內嵌函式時應該停止逐步執行範圍，則為 True。否則為 false。原生 DM 會針對中的步驟傳遞 true，因此步驟會在內嵌函式中停止。執行逐步執行時，它會傳遞 false，因此逐步執行程式不會在內嵌函式中停止。

傳回

DkmSteppingRange[]

[Out]要逐步執行的範圍陣列。如果沒有指定指令的來源資訊，此陣列將會是空的。

適用於

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

查詢符號提供者，以判斷基底偵錯監視器應該逐步執行以實作步驟的指示範圍。

位置條件約束：必須從監視元件呼叫 API， (元件層級 < 100,000) 。

此 API 是在 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))

參數

WorkList: DkmWorkList

要附加新工作專案的 WorkList。

ModuleInstance: DkmModuleInstance

[In]包含目前指令符號的模組實例。

StepStartingAddress: DkmInstructionAddress

[In，Optional]步驟開始位置的指示。在不尋常的情況下，可能是 Null，例如在堆疊上沒有畫面格的情況下開始步驟。請注意，這不一定是原生指令。

RangeBoundary: DkmSteppingRangeBoundary

[In]向符號提供者指出要包含在「無步驟」區域中的指示類型。

IncludeInline: Boolean

CompletionRoutine: DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>

要求完成時要引發的例程。如果成功將要求附加至工作清單，這一律會引發 (，包括取消作業時) 。如果附加工作項目失敗，則永遠不會引發此動作。

適用於