Freigeben über

RtlCaptureStackBackTrace-Funktion (winnt.h)

  • Artikel

Die RtlCaptureStackBackTrace-Routine erfasst eine Stapelrückverfolgung, indem sie den Stapel nach oben führt und die Informationen für jeden Frame aufzeichnet.

Syntax

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

Parameter

[in] FramesToSkip

Die Anzahl der Frames, die am Anfang der Rückverfolgung übersprungen werden sollen.

[in] FramesToCapture

Die Anzahl der zu erfassenden Frames.

[out] BackTrace

Ein Array von Zeigern, die aus der aktuellen Stapelüberwachung erfasst wurden.

[out, optional] BackTraceHash

Ein optionaler Wert, der zum Organisieren von Hashtabellen verwendet werden kann. Wenn dieser Parameter NULL ist, wird kein Hashwert berechnet.

Dieser Wert wird basierend auf den Werten der Im BackTrace-Array zurückgegebenen Zeiger berechnet. Zwei identische Stapelablaufverfolgungen generieren identische Hashwerte.

Rückgabewert

Die Anzahl der erfassten Frames.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar ab Windows XP.
Zielplattform Universell
Header winnt.h (include Ntifs.h, FltKernel.h)
Bibliothek NtosKrnl.lib; OneCoreUAP.lib auf Windows 10
DLL NtDll.dll (Benutzermodus); NtosKrnl.exe (Kernelmodus)
IRQL <= DISPATCH_LEVEL