Interface IDebugHostContext2 (dbgmodel.h)

Représente un contexte du débogueur répond aux questions sur (quelle session, processus, thread).

Cette version 2 de l’interface prend en charge toutes les méthodes précédentes avec des signatures identiques et inclut d’autres nouvelles méthodes qui fournissent des fonctionnalités ajoutées. Les nouvelles méthodes sont répertoriées dans l’en-tête à la fin de la section pour cette interface.

Héritage

IDebugHostContext hérite d’IDebugHostContext et IUnknown.

Méthode

L’interface IDebugHostContext2 a ces méthodes.

IDebugHostContext2 ::AddRef La méthode AddRef incrémente le nombre de références pour l’objet de contexte.
IDebugHostContext2 ::GetAddressSpaceRelation La méthode GetAddressSpaceRelation retourne la relation entre l’espace mémoire virtuelle du contexte actuel et celui d’un autre contexte spécifié.
IDebugHostContext2 ::IsEqualTo Retourne si deux objets IDebugHostContext sont égaux par valeur.
IDebugHostContext2 ::QueryInterface La méthode QueryInterface interroge une interface spécifique sur un objet de contexte hôte.
IDebugHostContext2 ::Release La méthode Release libère une référence au contexte hôte.

Remarques

Les objets de contexte sont des objets blob opaques d’informations que l’hôte de débogage (en coopération avec le modèle de données) associe à chaque objet. Il peut inclure des éléments tels que le contexte du processus ou l’espace d’adressage dont proviennent les informations, etc. Un objet de contexte est une implémentation d’IDebugHostContext boxed dans un IModelObject.

Notez que IDebugHostContext est une interface définie par l’hôte. Un client n’implémentera jamais cette interface.

contexte : espace d’adressage

Il est important de noter que contrairement aux modèles d’extension précédents où le contexte (la cible, le processus, le thread que vous examinez) est un concept d’interface utilisateur avec toutes les API relatives à l’état actuel de l’interface utilisateur, les interfaces de modèle de données prennent généralement ce contexte explicitement ou implicitement comme interface IDebugHostContext. Chaque IModelObject au sein du modèle de données porte ce type d’informations de contexte avec elle et peut propager ce contexte aux objets qu’il retourne. Cela signifie que lorsque vous lisez une valeur native ou une valeur clé à partir d’un IModelObject, il lit la cible et traite l’emplacement à partir duquel l’objet a été acquis à l’origine. Il existe une valeur constante explicite, USE_CURRENT_HOST_CONTEXT, qui peut être passée à des méthodes qui prennent un argument IDebugHostContext. Cette valeur indique que le contexte doit effectivement être l’état actuel de l’interface utilisateur du débogueur. Toutefois, cette notion doit être explicite.

Exigences

Exigence	Valeur
d’en-tête	dbgmodel.h

Voir aussi

Vue d’ensemble du modèle de données du débogueur C++