IMAGEHLP_STACK_FRAME Structure

Debug Help Library

IMAGEHLP_STACK_FRAME Structure

Contains the stack frame information. This structure is used with the SymSetContext function.

typedef struct _IMAGEHLP_STACK_FRAME {
ULONG64 InstructionOffset;
ULONG64 ReturnOffset;
ULONG64 FrameOffset;
ULONG64 StackOffset;
ULONG64 BackingStoreOffset;
ULONG64 FuncTableEntry;
ULONG64 Params[4];
ULONG64 Reserved[5];
BOOL Virtual;
ULONG Reserved2; } IMAGEHLP_STACK_FRAME,
*PIMAGEHLP_STACK_FRAME;

Members

InstructionOffset

The program counter.

x86:  The program counter is EIP.
Intel IPF:  The program counter is a combination of the bundle address and a slot indicator of 0, 4, or 8 for the slot within the bundle.
x64:  The program counter is RIP.
ReturnOffset

The return address.

FrameOffset

The frame pointer.

x86:  The frame pointer is EBP.
Intel IPF:  There is no frame pointer, but AddrBStore is used.
x64:  The frame pointer is RBP. AMD-64 does not always use this value.
StackOffset

The stack pointer.

x86:  The stack pointer is ESP.
Intel IPF:  The stack pointer is SP.
x64:  The stack pointer is RSP.
BackingStoreOffset
Intel IPF:  The backing store address.
FuncTableEntry
x86:  An FPO_DATA structure. If there is no function table entry, this member is NULL.
Params

The possible arguments to the function.

Reserved

This member is reserved for system use.

Virtual

If this is a virtual frame, this member is TRUE. Otherwise, this member is FALSE.

Reserved2

This member is reserved for system use.

Requirements

Redistributable

Requires DbgHelp.dll 5.1 or later.

Header

Declared in DbgHelp.h.

See Also

SymSetContext


Send comments about this topic to Microsoft

Build date: 9/25/2007

© 2007 Microsoft Corporation. All rights reserved.