DkmNativeInstructionSymbol.GetSteppingRanges Método

Definição

Namespace:

Microsoft.VisualStudio.Debugger.Native

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Pacote:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Sobrecargas

GetSteppingRanges(DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean)

Consulta o provedor de símbolos para determinar os intervalos de instruções que o monitor de depuração base deve percorrer para implementar uma etapa. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

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

Consulta o provedor de símbolos para determinar os intervalos de instruções que o monitor de depuração base deve percorrer para implementar uma etapa. Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetSteppingRanges(DkmModuleInstance, DkmInstructionAddress, DkmSteppingRangeBoundary, Boolean)

Consulta o provedor de símbolos para determinar os intervalos de instruções que o monitor de depuração base deve percorrer para implementar uma etapa.

Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000).

Essa API foi introduzida no 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);

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

Parâmetros

ModuleInstance

DkmModuleInstance

[In] Instância do módulo que contém o símbolo de instrução atual.

StepStartingAddress

DkmInstructionAddress

[In,Optional] Instrução em que a etapa começou. Pode ser nulo em situações incomuns, como iniciar a etapa sem quadros na pilha. Observe que isso não é necessariamente uma instrução nativa.

RangeBoundary

DkmSteppingRangeBoundary

[In] Indica ao provedor de símbolos o tipo de instruções a serem incluídas nas regiões "sem etapas".

IncludeInline

Boolean

[In] True se o provedor de símbolos deve parar o intervalo de etapas quando encontrar funções embutidas. De outra forma, falso. O DM nativo passará true para uma etapa em, portanto, as etapas serão interrompidas em funções embutidas. Ele passará false ao fazer um passo a passo para que o steper não pare em funções embutidas.

Retornos

DkmSteppingRange[]

[Out] Matriz de intervalos para percorrer. Essa matriz estará vazia se não houver informações de origem para a instrução fornecida.

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

Consulta o provedor de símbolos para determinar os intervalos de instruções que o monitor de depuração base deve percorrer para implementar uma etapa.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000).

Essa API foi introduzida no 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))

Parâmetros

WorkList

DkmWorkList

WorkList ao qual acrescentar o novo item de trabalho.

ModuleInstance

DkmModuleInstance

[In] Instância do módulo que contém o símbolo de instrução atual.

StepStartingAddress

DkmInstructionAddress

[In,Optional] Instrução em que a etapa começou. Pode ser nulo em situações incomuns, como iniciar a etapa sem quadros na pilha. Observe que isso não é necessariamente uma instrução nativa.

RangeBoundary

DkmSteppingRangeBoundary

[In] Indica ao provedor de símbolos o tipo de instruções a serem incluídas nas regiões "sem etapas".

IncludeInline

Boolean

[In] True se o provedor de símbolos deve parar o intervalo de etapas quando encontrar funções embutidas. De outra forma, falso. O DM nativo passará true para uma etapa em, portanto, as etapas serão interrompidas em funções embutidas. Ele passará false ao fazer um passo a passo para que o steper não pare em funções embutidas.

CompletionRoutine

DkmCompletionRoutine<DkmGetSteppingRangesAsyncResult>

Rotina a ser disparada quando a solicitação for concluída. Se a solicitação for acrescentada com êxito à lista de trabalho, isso sempre será acionado (inclusive quando a operação for cancelada). Isso nunca será acionado se o acréscimo do item de trabalho falhar.