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

Article
02/26/2024

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.