IDebugHost ::GetCurrentContext, méthode (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 ceci 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 actif dans l’interface utilisateur de l’hôte de débogage. L’objet de contexte retourné est largement opaque pour l’appelant, mais il est important de passer entre les appels à l’hôte de débogage. Lorsqu’un appelant est, par exemple, la lecture de la mémoire, il est important de connaître le processus et l’espace d’adressage à partir duquel la mémoire est lue. Cette notion est encapsulée dans la notion de l’objet de contexte retourné par cette méthode.
Chaque objet et symbole dans le modèle de données dispose éventuellement d’informations contextuelles telles que celles-ci 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 des objets existants. Ces 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 de retour
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)
}
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |