IDebugSymbols3 ::GetFunctionEntryByOffset, méthode (dbgeng.h)

Article
02/06/2025

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 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 sur les entrées artificielles ne sont pas utilisées.

[out, optional] Buffer

Reçoit les informations d’entrée de 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 pour cette architecture.

[in] BufferSize

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

[out, optional] BufferNeeded

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

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.
S_FALSE	La méthode a réussi, mais la mémoire tampon n’était pas suffisamment grande pour contenir les informations d’entrée de fonction et les informations ont donc été tronquées pour s’adapter.
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 sur l’image », qui est incluse dans les outils de débogage pour Windows dans le fichier DbgHelp.chm.

Remarque Les fonctions de « Bibliothèque d’aide sur l’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.