RtlCaptureStackBackTrace

Captures a stack back trace by walking up the stack and recording the information for each frame.

USHORT WINAPI RtlCaptureStackBackTrace(
  ULONG FramesToSkip,
  ULONG FramesToCapture,
  PVOID* BackTrace,
  PULONG BackTraceHash
);

Parameters

  • FramesToSkip
    [in] The number of frames to skip from the start of the back trace.

  • FramesToCapture
    [in] The number of frames to be captured.

    **Windows Server 2003 x64 edition:  **The sum of the FramesToSkip and FramesToCapture parameters must be less than 64.

  • BackTrace
    [out] An array of pointers captured from the current stack trace.

  • BackTraceHash
    [out, optional] A value that can be used to organize hash tables. If this parameter is NULL, then no hash value is computed.

Return Value

The number of captured frames.

Requirements

Server Requires Windows Server "Longhorn" x64 edition and Windows Server 2003 x64 edition.
Library

Use Kernel32.lib.

DLL Requires Kernel32.dll.