Partager via


IDebugRegisters2 ::GetInstructionOffset2, méthode (dbgeng.h)

La méthode GetInstructionOffset2 retourne l’emplacement de l’instruction actuelle du thread actuel.

Syntaxe

HRESULT GetInstructionOffset2(
  [in]  ULONG    Source,
  [out] PULONG64 Offset
);

Paramètres

[in] Source

Spécifie la source de registre à interroger.

Les valeurs possibles sont répertoriées dans le tableau suivant.

Valeur Inscrire la source
DEBUG_REGSRC_DEBUGGEE Récupérez les informations de registre à partir de la cible.
DEBUG_REGSRC_EXPLICIT Récupérez les informations de registre à partir du contexte de registre explicite actuel.
DEBUG_REGSRC_FRAME Récupérez les informations de registre du contexte de registre de l’étendue actuelle.
Note Le déroulement de la pile ne garantit pas la mise à jour exacte du contexte de registre, de sorte que le contexte de registre de la trame d’étendue peut ne pas être exact dans tous les cas.
 

[out] Offset

Reçoit l’emplacement dans l’espace d’adressage virtuel du processus de l’instruction actuelle du thread actuel.

Valeur retournée

Cette liste ne contient pas toutes les erreurs qui peuvent se produire. Pour obtenir la liste des erreurs possibles, consultez Valeurs HRESULT.

Code de retour Description
S_OK
La méthode a réussi.

Remarques

La signification de la valeur retournée par cette méthode dépend de l’architecture. En particulier, pour un processeur Itanium, l’adresse virtuelle retournée peut indiquer une adresse au sein d’un bundle.

La méthode GetInstructionOffset effectue la même tâche que cette méthode, mais utilise toujours la cible comme source de registre.

Pour obtenir une vue d’ensemble de l’interface IDebugRegisters et d’autres méthodes liées au registre, consultez Registres.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure DbgEng.h)

Voir aussi

GetInstructionOffset

IDebugRegisters2