DkmInstructionSymbol.GetSteppingRanges 方法

定义

命名空间:

Microsoft.VisualStudio.Debugger.Symbols

程序集:

Microsoft.VisualStudio.Debugger.Engine.dll

包:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

重载

GetSteppingRanges(DkmSteppingRangeBoundary, Boolean)	查询符号提供程序以确定基本调试监视器为实现步骤而应单步执行的说明范围。 位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。
GetSteppingRanges(DkmWorkList, DkmSteppingRangeBoundary, Boolean, DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>)	查询符号提供程序以确定基本调试监视器为实现步骤而应单步执行的说明范围。 此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。 位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。

GetSteppingRanges(DkmSteppingRangeBoundary, Boolean)

查询符号提供程序以确定基本调试监视器为实现步骤而应单步执行的说明范围。

位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。

public:
 cli::array <Microsoft::VisualStudio::Debugger::Symbols::DkmSteppingRange> ^ GetSteppingRanges(Microsoft::VisualStudio::Debugger::Symbols::DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline);

public:
 Platform::Array <Microsoft::VisualStudio::Debugger::Symbols::DkmSteppingRange> ^ GetSteppingRanges(Microsoft::VisualStudio::Debugger::Symbols::DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline);

std::Array <Microsoft::VisualStudio::Debugger::Symbols::DkmSteppingRange> GetSteppingRanges(Microsoft::VisualStudio::Debugger::Symbols::DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline);

public Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRange[] GetSteppingRanges (Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline);

member this.GetSteppingRanges : Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary * bool -> Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRange[]

Public Function GetSteppingRanges (RangeBoundary As DkmSteppingRangeBoundary, IncludeInline As Boolean) As DkmSteppingRange()

参数

RangeBoundary

DkmSteppingRangeBoundary

[In]向符号提供程序指示要包含在“无步骤”区域中的指令类型。

IncludeInline

Boolean

[In]如此 如果符号提供程序在遇到内联函数时应停止步进范围。 否则为 False。 本机 DM 将为 中的步骤传递 true，因此步骤将停止在内联函数中。 执行单步执行时，它会传递 false，因此步进器不会在内联函数中停止。

返回

DkmSteppingRange[]

[Out]要单步执行的范围数组。 如果给定指令没有源信息，则此数组将为空。

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

查询符号提供程序以确定基本调试监视器为实现步骤而应单步执行的说明范围。

此方法会将新工作项追加到指定的工作列表，并在追加工作项后返回 。 工作项的实际处理是异步的。 将通过完成例程通知调用方请求已完成。

位置约束：必须从监视组件 (组件级别 < 100,000) 调用 API。

public void GetSteppingRanges (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary RangeBoundary, bool IncludeInline, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Symbols.DkmGetSteppingRangesAsyncResult> CompletionRoutine);

member this.GetSteppingRanges : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.Symbols.DkmSteppingRangeBoundary * bool * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Symbols.DkmGetSteppingRangesAsyncResult> -> unit

Public Sub GetSteppingRanges (WorkList As DkmWorkList, RangeBoundary As DkmSteppingRangeBoundary, IncludeInline As Boolean, CompletionRoutine As DkmCompletionRoutine(Of DkmGetSteppingRangesAsyncResult))

参数

WorkList

DkmWorkList

要向其追加新工作项的 WorkList。

RangeBoundary

DkmSteppingRangeBoundary

[In]向符号提供程序指示要包含在“无步骤”区域中的指令类型。

IncludeInline

Boolean

[In]如此 如果符号提供程序在遇到内联函数时应停止步进范围。 否则为 False。 本机 DM 将为 中的步骤传递 true，因此步骤将停止在内联函数中。 执行单步执行时，它会传递 false，因此步进器不会在内联函数中停止。

CompletionRoutine

DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>

请求完成时触发的例程。 如果请求成功追加到工作列表，则始终会触发 (包括何时取消操作) 。 如果追加工作项失败，则永远不会触发此操作。