Partager via


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
S_OK
La méthode a réussi.
E_FAIL
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)

Voir aussi

GetContextStackTraceEx

GetFrameOffset2

GetInstructionOffset2

GetStackOffset2

IDebugControl5

OutputStackTraceEx

StackTrace

k, kb, kc, kd, kp, kP, kv (Display Stack Backtrace)