Interface IDebugHostContext2 (dbgmodel.h)

Representa um contexto do depurador que responde perguntas sobre (qual sessão, processo, thread).

Esta versão 2 da interface dá suporte a todos os métodos anteriores com assinaturas idênticas e inclui novos métodos adicionais que fornecem funcionalidade adicional. Os novos métodos são listados no cabeçalho no final da seção dessa interface.

Herança

IDebugHostContext herda de IDebugHostContext e IUnknown.

Métodos

A interface IDebugHostContext2 tem esses métodos.

IDebugHostContext2::AddRef O método AddRef incrementa a contagem de referência para o objeto de contexto.
IDebugHostContext2::GetAddressSpaceRelation O método GetAddressSpaceRelation retorna a relação entre o espaço de memória virtual do contexto atual e o de outro contexto especificado.
IDebugHostContext2::IsEqualTo Retorna se dois objetos IDebugHostContext são iguais por valor.
IDebugHostContext2::QueryInterface O método QueryInterface consulta uma interface específica em um objeto de contexto de host.
IDebugHostContext2::Release O método Release libera uma referência ao contexto do host.

Observações

Objetos de contexto são blobs opacos de informações que o host de depuração (em cooperação com o modelo de dados) associa a cada objeto. Pode incluir itens como o contexto do processo ou o espaço de endereço do qual as informações vêm, etc... Um objeto de contexto é uma implementação de IDebugHostContext em um IModelObject.

Observe que IDebugHostContext é uma interface definida pelo host. Um cliente nunca implementará essa interface.

contexto : o espaço de endereço

É importante observar que, ao contrário dos modelos de extensão anteriores em que o contexto (o destino, o processo, o thread que você está examinando) é um conceito de interface do usuário com todas as APIs relativas ao estado atual da interface do usuário, as interfaces do modelo de dados normalmente tomam esse contexto explicitamente ou implicitamente como uma interface IDebugHostContext. Cada IModelObject dentro do modelo de dados carrega esse tipo de informação de contexto junto com ele e pode propagar esse contexto para objetos retornados por ele. Isso significa que, quando você lê um valor nativo ou um valor de chave de um IModelObject, ele será lido fora do destino e do processo do qual o objeto foi originalmente adquirido. Há um valor constante explícito, USE_CURRENT_HOST_CONTEXT, que pode ser passado para métodos que levam um argumento IDebugHostContext. Esse valor indica que o contexto deve ser, de fato, o estado atual da interface do usuário do depurador. No entanto, essa noção precisa ser explícita.

Requisitos

Requisito	Valor
cabeçalho	dbgmodel.h

Consulte também

Visão geral do modelo de dados do depurador C++