IDebugControl2 ::GetNearInstruction, méthode (dbgeng.h)

Article
02/06/2025

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

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

Retourner le code	Description
S_OK	La méthode a réussi.

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 recherche vers l’arrière de offset jusqu’à ce qu’il rencontre un emplacement tel qu’il existe le Delta nombre d’instructions entre cet emplacement et Offset.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Partager via