This topic has not yet been rated - Rate this topic

STACKFRAME64 structure

Represents a stack frame.

Syntax


typedef struct _tagSTACKFRAME64 {
  ADDRESS64 AddrPC;
  ADDRESS64 AddrReturn;
  ADDRESS64 AddrFrame;
  ADDRESS64 AddrStack;
  ADDRESS64 AddrBStore;
  PVOID     FuncTableEntry;
  DWORD64   Params[4];
  BOOL      Far;
  BOOL      Virtual;
  DWORD64   Reserved[3];
  KDHELP64  KdHelp;
} STACKFRAME64, *LPSTACKFRAME64;

Members

AddrPC: An ADDRESS64 structure that specifies the program counter.

x86:  The program counter is EIP.

Intel Itanium:  The program counter is StIIP.

x64:  The program counter is RIP.
AddrReturn: An ADDRESS64 structure that specifies the return address.
AddrFrame: An ADDRESS64 structure that specifies the frame pointer.

x86:  The frame pointer is EBP.

Intel Itanium:  There is no frame pointer, but AddrBStore is used.

x64:  The frame pointer is RBP or RDI. This value is not always used.
AddrStack: An ADDRESS64 structure that specifies the stack pointer.

x86:  The stack pointer is ESP.

Intel Itanium:  The stack pointer is SP.

x64:  The stack pointer is RSP.
AddrBStore: Intel Itanium: An ADDRESS64 structure that specifies the backing store (RsBSP).
FuncTableEntry: On x86 computers, this member is an FPO_DATA structure. If there is no function table entry, this member is NULL.
Params: The possible arguments to the function.
Far: This member is TRUE if this is a WOW far call.
Virtual: This member is TRUE if this is a virtual frame.
Reserved: This member is used internally by the StackWalk64 function.
KdHelp: A KDHELP64 structure that specifies helper data for walking kernel callback frames.

Remarks

This structure supersedes the STACKFRAME structure. For more information, see Updated Platform Support. STACKFRAME is defined as follows in Dbghelp.h.

C++


#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define STACKFRAME STACKFRAME64
#define LPSTACKFRAME LPSTACKFRAME64
#else
typedef struct _tagSTACKFRAME {
    ADDRESS     AddrPC;
    ADDRESS     AddrReturn;
    ADDRESS     AddrFrame;
    ADDRESS     AddrStack;
    PVOID       FuncTableEntry;
    DWORD       Params[4];
    BOOL        Far;
    BOOL        Virtual; 
    DWORD       Reserved[3];
    KDHELP      KdHelp;
    ADDRESS     AddrBStore; 
} STACKFRAME, *LPSTACKFRAME;
#endif

Requirements

Redistributable	DbgHelp.dll 5.1 or later
Header	DbgHelp.h

Community Additions