Méthode IDebugControl ::GetNearInstruction (dbgeng.h)

  • Article

La méthode GetNearInstruction retourne l’emplacement d’une instruction de processeur par rapport à un emplacement donné.

Syntaxe

HRESULT GetNearInstruction(
  [in]  ULONG64  Offset,
  [in]  LONG     Delta,
  [out] PULONG64 NearOffset
);

Paramètres

[in] Offset

Spécifie l’emplacement dans l’espace d’adressage virtuel du processus à partir duquel commencer à rechercher l’instruction souhaitée.

[in] Delta

Spécifie le nombre d’instructions du décalage de l’instruction souhaitée. Si Delta est négatif, le décalage retourné est avant Offset (voir la section Remarques pour plus d’informations).

[out] NearOffset

Reçoit l’emplacement dans l’espace d’adressage virtuel du processus de l’instruction qui est instructions Delta loin de Offset.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

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

Remarques

Sur certaines architectures, telles que x86 et x64, la taille d’une instruction peut varier. Sur ces architectures, lorsque Delta est négatif, l’emplacement d’instruction souhaité peut ne pas être défini de manière unique. Dans ce cas, le moteur du débogueur effectue une recherche vers l’arrière à partir de Offset jusqu’à ce qu’il rencontre un emplacement tel qu’il existe le nombre delta d’instructions entre cet emplacement et Offset.

Configuration requise

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