IDebugControl2 ::OutputStackTrace, méthode (dbgeng.h)

Article
02/23/2024

La méthode OutputStackTrace génère le frame de pile fourni ou les trames de pile actuelles.

Syntaxe

HRESULT OutputStackTrace(
  [in]           ULONG              OutputControl,
  [in, optional] PDEBUG_STACK_FRAME Frames,
  [in]           ULONG              FramesSize,
  [in]           ULONG              Flags
);

Paramètres

[in] OutputControl

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

[in, optional] Frames

Spécifie le tableau de trames de pile à générer. Le nombre d’éléments dans ce tableau est FramesSize. Si frames a la valeur NULL, les trames de pile actuelles sont utilisées.

[in] FramesSize

Spécifie le nombre de trames à générer.

[in] Flags

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

Indicateur	Description
DEBUG_STACK_ARGUMENTS	Affiche les trois premiers morceaux de mémoire de pile au niveau du cadre de chaque appel. Sur les plateformes où les paramètres sont transmis sur la pile et où le code du frame 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 frame. Cela inclut la convention d’appel et les informations d’omission de pointeur de trame (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 de frame 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 numéros de cadre.
DEBUG_STACK_PARAMETERS	Affiche les noms et les valeurs des paramètres comme indiqués 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, ainsi que son type et sa valeur sur une nouvelle ligne.