Méthode IDebugControl5 ::GetStackTraceEx (dbgeng.h)
La méthode GetStackTraceEx retourne les trames en haut de la pile d’appels spécifiée. La méthode GetStackTraceEx prend en charge les trames inline. Pour plus d’informations sur l’utilisation des fonctions inline, consultez Débogage du code optimisé et Fonctions inline.
Syntaxe
HRESULT GetStackTraceEx(
[in] ULONG64 FrameOffset,
[in] ULONG64 StackOffset,
[in] ULONG64 InstructionOffset,
[out, writes] PDEBUG_STACK_FRAME_EX Frames,
[in] ULONG FramesSize,
[out, optional] PULONG FramesFilled
);
Paramètres
[in] FrameOffset
Spécifie l’emplacement du cadre de pile en haut de la pile. Si FrameOffset est défini sur zéro, le pointeur d’image actuel est utilisé à la place.
[in] StackOffset
Spécifie l’emplacement de la pile actuelle. Si StackOffset est défini sur zéro, le pointeur de pile actuel est utilisé à la place.
[in] InstructionOffset
Spécifie l’emplacement de l’instruction d’intérêt pour la fonction qui est représentée par le cadre de pile en haut de la pile. Si InstructionOffset a la valeur zéro, l’instruction actuelle est utilisée à la place.
[out, writes] Frames
Reçoit les trames de pile. Le nombre d’éléments que contient ce tableau est FrameSize.
[in] FramesSize
Spécifie le nombre d’éléments dans le tableau Frames .
[out, optional] FramesFilled
Reçoit le nombre d’images qui ont été placées dans le tableau Frames. Si FramesFilled a lavaleur NULL, ces informations ne sont pas retournées.
Valeur retournée
Cette méthode peut également retourner d’autres valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .
Code de retour | Description |
---|---|
|
La méthode a réussi. |
|
Aucun cadre de pile n’a été retourné. |
Remarques
La trace de pile retournée à Frames peut être imprimée à l’aide de OutputStackTraceEx.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | dbgeng.h (inclure Dbgeng.h) |