Undocumented functions of NTDLL

2OO5, 2 February


Gridstore - NonStop Storage

RtlCaptureStackBackTrace
RtlCaptureStackBackTrace

NTSYSAPI 
USHORT
NTAPI

RtlCaptureStackBackTrace(


  IN ULONG                FramesToSkip,
  IN ULONG                FramesToCapture,
  OUT PVOID               *BackTrace,
  OUT PULONG              BackTraceHash );



Function RtlCaptureStackBackTrace is usefull for debugging and analysing problems by making complete trace of calling functions by processing stack.
  • FramesToSkip
    •     How many stack entries should be skiped.
  • FramesToCapture
    •     Length of BackTrace buffer array.
  • BackTrace
    •     Array of caller's addresses.
  • BackTraceHash
    •     Unknown...

    As result function returns number of entries filled in BackTrace buffer, or zero in case of error.


    Supported on system versions:
    NT 4.0,Win 2000,Win XP/2003



    Documented by:
    Tomasz Nowak



    Requirements:
    Library: ntdll.lib


    See also:
    RtlGetCallersAddress