Partager via


Méthode IDebugSymbols3 ::GetFunctionEntryByOffset (dbgeng.h)

La méthode GetFunctionEntryByOffset retourne les informations d’entrée de fonction pour une fonction.

Syntaxe

HRESULT GetFunctionEntryByOffset(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BufferNeeded
);

Paramètres

[in] Offset

Spécifie un emplacement dans l’espace d’adressage virtuel du processus actuel de l’implémentation de la fonction. Il s’agit de la valeur retournée dans le paramètre Offset de GetNextSymbolMatch et IDebugSymbolGroup ::GetSymbolOffset, et de la valeur du champ Offset dans la structure DEBUG_SYMBOL_ENTRY .

[in] Flags

Spécifie un indicateur de bits qui modifie le comportement de cette méthode. Si le bit DEBUG_GETFNENT_RAW_ENTRY_ONLY n’est pas défini, le moteur fournit des entrées artificielles pour les cas connus. Si ce bit est défini, les entrées artificielles ne sont pas utilisées.

[out, optional] Buffer

Reçoit les informations d’entrée de la fonction. Si le processeur effectif est un x86, il s’agit de la structure FPO_DATA de la fonction . Pour toutes les autres architectures, il s’agit de la structure IMAGE_FUNCTION_ENTRY de cette architecture.

[in] BufferSize

Spécifie la taille de la mémoire tampon.

[out, optional] BufferNeeded

Spécifie la taille des informations d’entrée de fonction.

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.
S_FALSE
La méthode a réussi, mais la mémoire tampon n’était pas assez grande pour contenir les informations d’entrée de fonction et les informations ont donc été tronquées pour tenir.
E_NOINTERFACE
Aucune information d’entrée de fonction n’a été trouvée pour l’emplacement Offset.

Remarques

Les structures FPO_DATA et IMAGE_FUNCTION_ENTRY sont documentées dans « Bibliothèque d’aide d’images », qui est incluse dans Outils de débogage pour Windows dans le fichier DbgHelp.chm.

Note Les fonctions dans « Bibliothèque d’aide d’image » et « Bibliothèque d’aide de débogage », documentées dans DbgHelp.chm, ne doivent pas être appelées par une application de moteur d’extension ou de débogueur.
 
Pour plus d’informations sur les symboles, consultez Symboles.

Configuration requise

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

Voir aussi

DEBUG_SYMBOL_ENTRY

GetNextSymbolMatch

IDebugSymbolGroup ::GetSymbolOffset

IDebugSymbols3