STACKTRACEENTRY

3.1

#include <toolhelp.h>

typedef struct tagSTACKTRACEENTRY {  /* ste */
    DWORD   dwSize;
    HTASK   hTask;
    WORD    wSS;
    WORD    wBP;
    WORD    wCS;
    WORD    wIP;
    HMODULE hModule;
    WORD    wSegment;
    WORD    wFlags;
} STACKTRACEENTRY;

The STACKTRACEENTRY structure contains information about one stack frame. This information enables an application to trace back through the stack of a specific task.

Members

dwSize

Specifies the size of the STACKTRACEENTRY structure, in bytes.

hTask

Identifies the task handle for the stack.

wSS

Contains the value in the SS register. This value is used with the value of the wBP member to determine the next entry in the stack-trace table.

wBP

Contains the value in the BP register. This value is used with the wSS value to determine the next entry in the stack-trace table.

wCS

Contains the value in the CS register on return. This value is used with the value of the wIP member to determine the return value of the function.

wIP

Contains the value in the IP register on return. This value is used with the wCS value to determine the return value of the function.

hModule

Identifies the module that contains the currently executing function.

wSegment

Contains the segment number of the current selector.

wFlags

Indicates the frame type. This type can be one of the following values:

Value Meaning

FRAME_FAR The CS register contains a valid code segment.
FRAME_NEAR The CS register is null.

See Also

StackTraceCSIPFirst, StackTraceNext, StackTraceFirst