CaptureStackBackTrace-Funktion
BESCHREIBUNG
Erfasst eine Stapelrückverfolgung, indem der Stapel hochläuft und die Informationen für jeden Frame aufgezeichnet werden.
USHORT WINAPI CaptureStackBackTrace(
_In_ ULONG FramesToSkip,
_In_ ULONG FramesToCapture,
_Out_ PVOID *BackTrace,
_Out_opt_ PULONG BackTraceHash
);
Parameter
FramesToSkip [in]
Die Anzahl der Frames, die ab dem Anfang der Rückverfolgung übersprungen werden sollen.
FramesToCapture [in]
Die Anzahl der zu erfassenden Frames. Sie können bis zu MAXUSHORT-Frames erfassen.
Windows Server 2003 und Windows XP: Die Summe der FramesToSkip- und FramesToCapture-Parameter muss kleiner als 63 sein.
BackTrace [out]
Ein Array von Zeigern, die aus der aktuellen Stapelüberwachung erfasst werden.
BackTraceHash [out, optional]
Ein -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 Zeiger berechnet, die im BackTrace-Array zurückgegeben werden. Zwei identische Stapelüberwachungen generieren identische Hashwerte.
Gibt zurück
Die Anzahl der erfassten Frames.
Hinweise
Die CaptureStackBackTrace-Funktion ist als die RtlCaptureStackBackTrace-Funktion definiert (die Definition ist ab Windows Vista im Windows SDK enthalten). Weitere Informationen finden Sie unter WinBase.h und WinNT.h.