IDebugControl4 ::GetContextStackTrace, méthode (dbgeng.h)

La méthode GetContextStackTrace retourne les images en haut de la pile des appels, en commençant par un contexte d’enregistrement arbitraire et en retournant le contexte de registre reconstruit pour chaque trame de pile.

Syntaxe

HRESULT GetContextStackTrace(
  [in, optional]  PVOID              StartContext,
  [in]            ULONG              StartContextSize,
  [out, optional] PDEBUG_STACK_FRAME Frames,
  [in]            ULONG              FramesSize,
  [out, optional] PVOID              FrameContexts,
  [in]            ULONG              FrameContextsSize,
  [in]            ULONG              FrameContextsEntrySize,
  [out, optional] PULONG             FramesFilled
);

Paramètres

[in, optional] StartContext

Spécifie le contexte d’inscription pour le haut de la pile.

[in] StartContextSize

Spécifie la taille, en octets, du contexte d’inscription StartContext.

[out, optional] Frames

Reçoit les trames de pile. Le nombre d’éléments que contient ce tableau est FrameSize. Si frames est NULL, ces informations ne sont pas retournées.

[in] FramesSize

Spécifie le nombre d’éléments du tableau Frames.

[out, optional] FrameContexts

Reçoit le contexte de registre reconstruit pour chaque image 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. Si FrameContexts est NULL, ces informations ne sont pas retournées.

[in] FrameContextsSize

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

[in] FrameContextsEntrySize

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

[out, optional] FramesFilled

Reçoit le nombre d’images qui ont été placées dans le tableau Frames et les contextes dans FrameContexts. Si framesFilled est NULL, ces informations ne sont pas retournées.

Valeur de retour

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

Remarques

La trace de pile retournée à Frames et FrameContexts peuvent être imprimées à l’aide de OutputContextStackTrace.

Il est courant que les déroulements de pile restaurent uniquement un sous-ensemble des registres. Par exemple, les déroulements de pile ne restaurent pas toujours l’état du registre volatile, car les registres volatiles sont des registres à zéro et le code n’a pas besoin de les conserver. Les registres qui ne sont pas restaurés lors du déroulement sont laissés comme dernière valeur restaurée. Vous devez donc veiller à utiliser l’état de registre qui ne peut pas être restauré par un déroulement.

Exigences

Voir aussi

GetStackTrace

IDebugControl4

OutputContextStackTrace

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