Méthode IDebugHost ::GetCurrentContext (dbgmodel.h)

La méthode GetCurrentContext retourne une interface qui représente l’état actuel de l’hôte du débogueur. La signification exacte de cela est laissée à l’hôte, mais elle inclut généralement des éléments tels que la session, le processus et l’espace d’adressage qui est actif dans l’interface utilisateur de l’hôte de débogage. L’objet de contexte retourné est en grande partie opaque pour l’appelant, mais il s’agit d’un objet important à passer entre les appels à l’hôte de débogage. Lorsqu’un appelant lit de la mémoire pour instance, il est important de savoir de quel processus et de quel espace d’adressage la mémoire est lue. Cette notion est encapsulée dans la notion de l’objet de contexte qui est retourné par cette méthode.

Chaque objet et symbole du modèle de données a éventuellement des informations de contexte telles que celles-ci qui lui sont associées. Il est également souvent courant que le contexte soit passé d’un objet à de nouveaux objets créés en tant que propriétés d’un objet existant. De tels objets créés par l’hôte de débogage lui-même peuvent entraîner l’incorporation d’informations de contexte supplémentaires dans l’objet retourné (par exemple, la propriété Stack d’un thread peut incorporer des informations sur le thread auquel la pile fait référence dans le contexte).

Syntaxe

HRESULT GetCurrentContext(
  IDebugHostContext **context
);

Paramètres

context

Un objet représentant le contexte actuel de l’hôte est retourné ici.

Valeur retournée

Cette méthode retourne HRESULT qui indique la réussite ou l’échec. Un hôte qui n’a pas de concept d’informations de contexte peut retourner E_NOTIMPL ici.

Remarques

Exemple de code

ComPtr<IDebugHost> spHost; /* get the debug host */

ComPtr<IDebugHostContext> spContext;
if (SUCCEEDED(spHost->GetCurrentContext(&spContext)))
{
    // spContext now contains an opaque object representing the current UI 
    // state of the debugger (e.g.: what session/process/thread the debug UI 
    // is focused on)
}

Configuration requise

Voir aussi

Interface IDebugHost