Compartilhar via


DkmMonitorStackWalkContext Classe

Definição

DkmMonitorStackWalkContext permite os vários componentes DkmSymbolStackWalkContext com essa pilha de chamadas.

public ref class DkmMonitorStackWalkContext : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable
[System.Runtime.InteropServices.Guid("4ce2f85d-5b40-4a4c-5eba-79e9228e48b1")]
public class DkmMonitorStackWalkContext : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable
[<System.Runtime.InteropServices.Guid("4ce2f85d-5b40-4a4c-5eba-79e9228e48b1")>]
type DkmMonitorStackWalkContext = class
    inherit DkmDataContainer
    interface IDisposable
Public Class DkmMonitorStackWalkContext
Inherits DkmDataContainer
Implements IDisposable
Herança
DkmMonitorStackWalkContext
Herança
DkmMonitorStackWalkContext
Atributos
Implementações

Propriedades

Flags

Sinalizadores para controlar quadros retornados durante uma caminhada de pilha.

Essa API foi introduzida no Visual Studio 17 Atualização 3 (DkmApiVersion.VS17Update3).

IsUnloaded

Retornará true se um evento 'descarregado' tiver sido gerado para este objeto (exemplo: DkmThread::Unload for chamado) ou se o objeto tiver sido fechado. Observe que o cuidado deve ser usado ao verificar esse status como, sem sincronização, o status retornado pode não ser mais preciso após a leitura.

(Herdado de DkmDataContainer)
RuntimeInstance

A classe DkmRuntimeInstance representa um ambiente de execução carregado em um DkmProcess e que contém código a ser depurado.

Thread

DkmThread representa um thread em execução no processo de destino.

ThreadContext

[Opcional] O CONTEXTO inicial do Win32 a ser usado ao executar a caminhada de pilha. Esse valor normalmente é "nulo", mas pode ser definido para exibir outra pilha de chamadas (por exemplo: .cxr).

UniqueId

Guid que identifica exclusivamente este DkmMonitorStackWalkContext.

Métodos

Close()

Fecha uma instância de objeto DkmMonitorStackWalkContext. Isso liberará todos os recursos associados a esse objeto em todos os componentes. Isso inclui recursos em limites de marshalling gerenciados/nativos ou computador.

Os objetos DkmMonitorStackWalkContext são fechados automaticamente quando o objeto DkmThread associado é fechado.

Esse método só pode ser chamado pelo componente que criou o objeto .

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

Create(DkmRuntimeInstance, DkmThread, ReadOnlyCollection<Byte>, DkmDataItem)

Create uma nova instância de objeto DkmMonitorStackWalkContext. O chamador é responsável por fechar o objeto criado após a conclusão.

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

Create(DkmRuntimeInstance, DkmThread, ReadOnlyCollection<Byte>, DkmStackWalkContextFlags, DkmDataItem)

Create uma nova instância de objeto DkmMonitorStackWalkContext. O chamador é responsável por fechar o objeto criado após a 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 17 Atualização 3 (DkmApiVersion.VS17Update3).

GetDataItem<T>()

Obtém a instância de 'T' que foi adicionada a essa instância de contêiner. Se esse contêiner não contiver um 'T', essa função retornará nulo.

(Herdado de DkmDataContainer)
Initialize(DkmFrameRegisters, UInt32)

Inicializar é invocado em cada andador exatamente uma vez no início do processo de caminhada. Isso dá a cada andador a chance de inicializar qualquer estado.

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

RemoveDataItem<T>()

Remova a instância de 'T' desse contêiner. Geralmente, é desnecessário chamar esse método, pois um contêiner de dados será esvaziado automaticamente quando o objeto for fechado.

(Herdado de DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Coloque um novo item no contêiner de dados.

(Herdado de DkmDataContainer)
UpdatePosition(DkmFrameRegisters, UInt32)

UpdatePosition é invocado pela fusão de pilha após outro andador ter andado um ou mais quadros e, portanto, esse andador deve ser atualizado antes de invocar WalkNextFrame. Os runtimes que mantêm seu próprio estado de intervalo de pilha interno dentro no processo de destino provavelmente não terão nada a ver com esse método.

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

WalkNextFrame()

Tente percorrer o próximo quadro de pilha. A estrutura DkmMonitorStackWalkResult indica se esse monitor foi capaz de percorrer o quadro.

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

Implantações explícitas de interface

IDisposable.Dispose()

DkmMonitorStackWalkContext permite os vários componentes DkmSymbolStackWalkContext com essa pilha de chamadas.

Aplica-se a