Interface IDebugHostContext (dbgmodel.h)

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

Héritage

IDebugHostContext hérite d’IUnknown.

Méthodes

L’interface IDebugHostContext possède ces méthodes.

IDebugHostContext ::AddRef La méthode IDebugHostContext ::AddRef incrémente le nombre de références pour une interface sur un objet.
IDebugHostContext ::IsEqualTo Retourne si deux objets IDebugHostContext sont égaux par valeur.
IDebugHostContext ::QueryInterface La méthode IDebugHostContext ::QueryInterface récupère les pointeurs vers les interfaces prises en charge sur un objet.
IDebugHostContext ::Release La méthode IDebugHostContext ::Release décrémente le nombre de références pour une interface sur un objet.

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 de processus ou l’espace d’adressage dont proviennent les informations, etc... Un objet de contexte est une implémentation d’IDebugHostContext boxée 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 par rapport à 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 une interface IDebugHostContext. Chaque IModelObject dans le modèle de données contient ce type d’informations de contexte et peut propager ce contexte aux objets qu’il retourne. Cela signifie que lorsque vous lisez une valeur native ou une valeur de clé à partir d’un IModelObject, il lit la cible et traite l’emplacement d’où l’objet a été acquis à l’origine. Il existe une valeur constante explicite, USE_CURRENT_HOST_CONTEXT, qui peut être transmise aux 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.

Configuration requise

Condition requise	Valeur
En-tête	dbgmodel.h

Voir aussi

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