Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
|---|---|
|
La méthode a réussi. |
|
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. |
|
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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dbgeng.h (include Dbgeng.h, Winnt.h) |