Fonction RtlCaptureStackBackTrace (winnt.h)

La routine RtlCaptureStackBackTrace capture une trace de retour de pile en remontant la pile et en enregistrant les informations pour chaque image.

Syntaxe

NTSYSAPI WORD RtlCaptureStackBackTrace(
  [in]            DWORD  FramesToSkip,
  [in]            DWORD  FramesToCapture,
  [out]           PVOID  *BackTrace,
  [out, optional] PDWORD BackTraceHash
);

Paramètres

[in] FramesToSkip

Nombre de frames à ignorer à partir du début de la trace.

[in] FramesToCapture

Nombre de frames à capturer.

[out] BackTrace

Tableau de pointeurs capturés à partir de l’arborescence des appels de procédure actuelle.

[out, optional] BackTraceHash

Valeur facultative qui peut être utilisée pour organiser les tables de hachage. Si ce paramètre a la valeur NULL, aucune valeur de hachage n’est calculée.

Cette valeur est calculée en fonction des valeurs des pointeurs retournés dans le tableau BackTrace . Deux arborescences des appels de procédure identiques génèrent des valeurs de hachage identiques.

Valeur retournée

Nombre de frames capturés.

Configuration requise