IDebugControl5 ::OutputContextStackTraceEx, méthode (dbgeng.h)

Article
02/06/2025

La méthode OutputContextStackTraceEx imprime la pile des appels spécifiée par un tableau d’images de pile et des contextes de registre correspondants. La méthode OutputContextStackTraceEx fournit une prise en charge d’images inline. Pour plus d’informations sur l’utilisation des fonctions inline, consultez Débogage de code optimisé et de fonctions inline.

Syntaxe

HRESULT OutputContextStackTraceEx(
  [in] ULONG                 OutputControl,
  [in] PDEBUG_STACK_FRAME_EX Frames,
  [in] ULONG                 FramesSize,
  [in] PVOID                 FrameContexts,
  [in] ULONG                 FrameContextsSize,
  [in] ULONG                 FrameContextsEntrySize,
  [in] ULONG                 Flags
);

Paramètres

[in] OutputControl

Spécifie où envoyer la sortie. Pour connaître les valeurs possibles, consultez DEBUG_OUTCTL_XXX.

[in] Frames

Spécifie le tableau d’images de pile à générer. Le nombre d’éléments de ce tableau est FramesSize. Si frames est NULL, le cadre de pile actuel est utilisé.

[in] FramesSize

Spécifie le nombre d’images à générer.

[in] FrameContexts

Spécifie le contexte d’inscription pour chaque frame de la pile. Les entrées de ce tableau correspondent aux entrées du tableau Frames. Le type du contexte de thread est la structure CONTEXT du processeur effectif de la cible.

[in] FrameContextsSize

Spécifie la taille, en octets, de la mémoire pointée par FrameContexts. Le nombre d’images de pile doit être égal au nombre de contextes et FrameContextsSize doit être égal à FramesSize multiplié par FrameContextsEntrySize.

[in] FrameContextsEntrySize

Spécifie la taille, en octets, de chaque contexte d’image dans FrameContexts.

[in] Flags

Spécifie les indicateurs de bits qui déterminent les informations à générer pour chaque image. indicateurs peut être n’importe quelle combinaison de valeurs du tableau suivant.

Drapeau	Description
DEBUG_STACK_ARGUMENTS	Affiche les trois premières parties de la mémoire de pile au niveau de l’image de chaque appel. Sur les plateformes où les arguments sont transmis sur la pile et que le code de la trame utilise des arguments de pile, ces valeurs sont les arguments de la fonction.
DEBUG_STACK_FUNCTION_INFO	Affiche des informations sur la fonction qui correspond au cadre. Cela inclut les informations de convention d’appel et d’omission de pointeur d’image (FPO).
DEBUG_STACK_SOURCE_LINE	Affiche les informations de ligne source pour chaque image de la trace de pile.
DEBUG_STACK_FRAME_ADDRESSES	Affiche l’adresse de retour, l’adresse d’image précédente et d’autres adresses pertinentes pour chaque image.
DEBUG_STACK_COLUMN_NAMES	Affiche les noms de colonnes.
DEBUG_STACK_NONVOLATILE_REGISTERS	Affiche le contexte de registre non volatile pour chaque image. Cela n’est significatif que pour certaines plateformes.
DEBUG_STACK_FRAME_NUMBERS	Affiche les nombres d’images.
DEBUG_STACK_PARAMETERS	Affiche les noms et les valeurs des paramètres comme indiqué dans les informations de symbole.
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY	Affiche uniquement l’adresse de retour dans les adresses de trame de pile.
DEBUG_STACK_FRAME_MEMORY_USAGE	Affiche le nombre d’octets qui séparent les images.
DEBUG_STACK_PARAMETERS_NEWLINE	Affiche chaque paramètre et son type et sa valeur sur une nouvelle ligne.

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

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h

Voir aussi

IDebugControl5

Partager via