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

Article
02/26/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 d’images 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 d’images à sortir.

[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 dans le cadre de chaque appel. Sur les plateformes où les paramètres sont transmis sur la pile et où le code du cadre utilise des arguments de pile, ces valeurs seront les arguments de la fonction.
DEBUG_STACK_FUNCTION_INFO	Affiche des informations sur la fonction qui correspond au cadre. Cela inclut les informations relatives à la convention d’appel et à l’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 de trame 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 trame.
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, son type et sa valeur sur une nouvelle ligne.