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.

Weitere Informationen