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

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 à partir du décalage de l’instruction souhaitée. Si Delta est négatif, le décalage retourné est avant Décalage (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 .

Remarques

Sur certaines architectures, comme 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 de 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