Méthode IDebugControl ::GetStackTrace (dbgeng.h)

La méthode GetStackTrace retourne les frames 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 frame de pile en haut de la pile. Si FrameOffset a la valeur 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 intéressante pour la fonction représentée par le frame 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 de trames qui ont été placées dans le tableau Frames. Si FramesFilled a la valeur 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 OutputStackTrace.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)

Voir aussi

GetContextStackTrace

GetFrameOffset2

GetInstructionOffset2

GetStackOffset2

IDebugControl

IDebugControl2

IDebugControl3

OutputStackTrace

StackTrace

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