Fonction RtlCaptureStackBackTrace (winnt.h)

Article
08/27/2023

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


Client minimal pris en charge	Disponible à partir de Windows XP.
Plateforme cible	Universal
En-tête	winnt.h (inclure Ntifs.h, FltKernel.h)
Bibliothèque	NtosKrnl.lib; OneCoreUAP.lib sur Windows 10
DLL	NtDll.dll (mode utilisateur) ; NtosKrnl.exe (mode noyau)
IRQL	<= DISPATCH_LEVEL

Partager via