Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
BESCHREIBUNG
Erfasst eine Stapelrückverfolgung, indem der Stapel nach oben geht 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 am 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 Parameter FramesToSkip und FramesToCapture muss kleiner als 63 sein.
BackTrace [out]
Ein Array von Zeigern, die aus der aktuellen Stapelüberwachung erfasst wurden.
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 Im BackTrace-Array zurückgegebenen Zeiger berechnet. Zwei identische Stapelablaufverfolgungen generieren identische Hashwerte.
Gibt zurück
Die Anzahl der erfassten Frames.
Bemerkungen
Die CaptureStackBackTrace-Funktion ist als RtlCaptureStackBackTrace-Funktion definiert (die Definition ist im Windows SDK ab Windows Vista enthalten). Weitere Informationen finden Sie unter WinBase.h und WinNT.h.