Partager via


IDebugControl ::GetStackTrace, méthode (dbgeng.h)

La méthode GetStackTrace retourne les images en haut de la pile d’appels spécifiée.

Syntaxe

HRESULT GetStackTrace(
  [in]            ULONG64            FrameOffset,
  [in]            ULONG64            StackOffset,
  [in]            ULONG64            InstructionOffset,
  [out, writes]   PDEBUG_STACK_FRAME 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 représentée par le cadre de pile en haut de la pile. Si instructionOffset est définie sur 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 est NULL, ces informations ne sont pas retournées.

Valeur de retour

Cette méthode peut également retourner d’autres valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code Description
S_OK
La méthode a réussi.
E_FAIL
Aucune trame de pile n’a été retournée.

Remarques

La trace de pile retournée à Frames peut être imprimée à l’aide de OutputStackTrace.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête dbgeng.h (include Dbgeng.h)

Voir aussi

GetContextStackTrace

getFrameOffset2

GetInstructionOffset2

GetStackOffset2

IDebugControl

IDebugControl2

IDebugControl3

outputStackTrace

StackTrace

k, kb, kc, kd, kp, kP, kv (backtrace de pile d’affichage)