Win32 API 日本語リファレンス
ホームSystem.Diagnostics.Debug › STACKFRAME

STACKFRAME

構造体
サイズx64: 168 バイト / x86: 164 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
AddrPCADDRESS12+0+0プログラムカウンタ(命令ポインタ)のアドレスを示す。
AddrReturnADDRESS12+12+12リターンアドレスを示す。
AddrFrameADDRESS12+24+24フレームポインタのアドレスを示す。
AddrStackADDRESS12+36+36スタックポインタのアドレスを示す。
FuncTableEntryvoid*8/4+48+48関数テーブルエントリを指すポインタ。
ParamsDWORD16+56+52関数の引数値(最初の4つ)を保持する配列。
FarBOOL4+72+68ファーコールかどうかを示すフラグ。
VirtualBOOL4+76+72仮想フレームかどうかを示すフラグ。
ReservedDWORD12+80+76予約フィールド。使用しない。
KdHelpKDHELP64+92+88カーネルデバッグ補助情報(KDHELP)を保持する。
AddrBStoreADDRESS12+156+152バッキングストアのアドレスを示す。主に Itanium 用。

各言語での定義

#include <windows.h>

// ADDRESS  (x64 12 / x86 12 バイト)
typedef struct ADDRESS {
    DWORD Offset;
    WORD Segment;
    ADDRESS_MODE Mode;
} ADDRESS;

// KDHELP  (x64 64 / x86 64 バイト)
typedef struct KDHELP {
    DWORD Thread;
    DWORD ThCallbackStack;
    DWORD NextCallback;
    DWORD FramePointer;
    DWORD KiCallUserMode;
    DWORD KeUserCallbackDispatcher;
    DWORD SystemRangeStart;
    DWORD ThCallbackBStore;
    DWORD KiUserExceptionDispatcher;
    DWORD StackBase;
    DWORD StackLimit;
    DWORD Reserved[5];
} KDHELP;

// STACKFRAME  (x64 168 / x86 164 バイト)
typedef struct STACKFRAME {
    ADDRESS AddrPC;
    ADDRESS AddrReturn;
    ADDRESS AddrFrame;
    ADDRESS AddrStack;
    void* FuncTableEntry;
    DWORD Params[4];
    BOOL Far;
    BOOL Virtual;
    DWORD Reserved[3];
    KDHELP KdHelp;
    ADDRESS AddrBStore;
} STACKFRAME;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ADDRESS
{
    public uint Offset;
    public ushort Segment;
    public int Mode;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KDHELP
{
    public uint Thread;
    public uint ThCallbackStack;
    public uint NextCallback;
    public uint FramePointer;
    public uint KiCallUserMode;
    public uint KeUserCallbackDispatcher;
    public uint SystemRangeStart;
    public uint ThCallbackBStore;
    public uint KiUserExceptionDispatcher;
    public uint StackBase;
    public uint StackLimit;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 5)] public uint[] Reserved;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct STACKFRAME
{
    public ADDRESS AddrPC;
    public ADDRESS AddrReturn;
    public ADDRESS AddrFrame;
    public ADDRESS AddrStack;
    public IntPtr FuncTableEntry;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public uint[] Params;
    [MarshalAs(UnmanagedType.Bool)] public bool Far;
    [MarshalAs(UnmanagedType.Bool)] public bool Virtual;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)] public uint[] Reserved;
    public KDHELP KdHelp;
    public ADDRESS AddrBStore;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ADDRESS
    Public Offset As UInteger
    Public Segment As UShort
    Public Mode As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KDHELP
    Public Thread As UInteger
    Public ThCallbackStack As UInteger
    Public NextCallback As UInteger
    Public FramePointer As UInteger
    Public KiCallUserMode As UInteger
    Public KeUserCallbackDispatcher As UInteger
    Public SystemRangeStart As UInteger
    Public ThCallbackBStore As UInteger
    Public KiUserExceptionDispatcher As UInteger
    Public StackBase As UInteger
    Public StackLimit As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=5)> Public Reserved() As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure STACKFRAME
    Public AddrPC As ADDRESS
    Public AddrReturn As ADDRESS
    Public AddrFrame As ADDRESS
    Public AddrStack As ADDRESS
    Public FuncTableEntry As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public Params() As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public Far As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public Virtual As Boolean
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=3)> Public Reserved() As UInteger
    Public KdHelp As KDHELP
    Public AddrBStore As ADDRESS
End Structure
import ctypes
from ctypes import wintypes

class ADDRESS(ctypes.Structure):
    _fields_ = [
        ("Offset", wintypes.DWORD),
        ("Segment", ctypes.c_ushort),
        ("Mode", ctypes.c_int),
    ]

class KDHELP(ctypes.Structure):
    _fields_ = [
        ("Thread", wintypes.DWORD),
        ("ThCallbackStack", wintypes.DWORD),
        ("NextCallback", wintypes.DWORD),
        ("FramePointer", wintypes.DWORD),
        ("KiCallUserMode", wintypes.DWORD),
        ("KeUserCallbackDispatcher", wintypes.DWORD),
        ("SystemRangeStart", wintypes.DWORD),
        ("ThCallbackBStore", wintypes.DWORD),
        ("KiUserExceptionDispatcher", wintypes.DWORD),
        ("StackBase", wintypes.DWORD),
        ("StackLimit", wintypes.DWORD),
        ("Reserved", wintypes.DWORD * 5),
    ]

class STACKFRAME(ctypes.Structure):
    _fields_ = [
        ("AddrPC", ADDRESS),
        ("AddrReturn", ADDRESS),
        ("AddrFrame", ADDRESS),
        ("AddrStack", ADDRESS),
        ("FuncTableEntry", ctypes.c_void_p),
        ("Params", wintypes.DWORD * 4),
        ("Far", wintypes.BOOL),
        ("Virtual", wintypes.BOOL),
        ("Reserved", wintypes.DWORD * 3),
        ("KdHelp", KDHELP),
        ("AddrBStore", ADDRESS),
    ]
#[repr(C)]
pub struct ADDRESS {
    pub Offset: u32,
    pub Segment: u16,
    pub Mode: i32,
}

#[repr(C)]
pub struct KDHELP {
    pub Thread: u32,
    pub ThCallbackStack: u32,
    pub NextCallback: u32,
    pub FramePointer: u32,
    pub KiCallUserMode: u32,
    pub KeUserCallbackDispatcher: u32,
    pub SystemRangeStart: u32,
    pub ThCallbackBStore: u32,
    pub KiUserExceptionDispatcher: u32,
    pub StackBase: u32,
    pub StackLimit: u32,
    pub Reserved: [u32; 5],
}

#[repr(C)]
pub struct STACKFRAME {
    pub AddrPC: ADDRESS,
    pub AddrReturn: ADDRESS,
    pub AddrFrame: ADDRESS,
    pub AddrStack: ADDRESS,
    pub FuncTableEntry: *mut core::ffi::c_void,
    pub Params: [u32; 4],
    pub Far: i32,
    pub Virtual: i32,
    pub Reserved: [u32; 3],
    pub KdHelp: KDHELP,
    pub AddrBStore: ADDRESS,
}
import "golang.org/x/sys/windows"

type ADDRESS struct {
	Offset uint32
	Segment uint16
	Mode int32
}

type KDHELP struct {
	Thread uint32
	ThCallbackStack uint32
	NextCallback uint32
	FramePointer uint32
	KiCallUserMode uint32
	KeUserCallbackDispatcher uint32
	SystemRangeStart uint32
	ThCallbackBStore uint32
	KiUserExceptionDispatcher uint32
	StackBase uint32
	StackLimit uint32
	Reserved [5]uint32
}

type STACKFRAME struct {
	AddrPC ADDRESS
	AddrReturn ADDRESS
	AddrFrame ADDRESS
	AddrStack ADDRESS
	FuncTableEntry uintptr
	Params [4]uint32
	Far int32
	Virtual int32
	Reserved [3]uint32
	KdHelp KDHELP
	AddrBStore ADDRESS
}
type
  ADDRESS = record
    Offset: DWORD;
    Segment: Word;
    Mode: Integer;
  end;

  KDHELP = record
    Thread: DWORD;
    ThCallbackStack: DWORD;
    NextCallback: DWORD;
    FramePointer: DWORD;
    KiCallUserMode: DWORD;
    KeUserCallbackDispatcher: DWORD;
    SystemRangeStart: DWORD;
    ThCallbackBStore: DWORD;
    KiUserExceptionDispatcher: DWORD;
    StackBase: DWORD;
    StackLimit: DWORD;
    Reserved: array[0..4] of DWORD;
  end;

  STACKFRAME = record
    AddrPC: ADDRESS;
    AddrReturn: ADDRESS;
    AddrFrame: ADDRESS;
    AddrStack: ADDRESS;
    FuncTableEntry: Pointer;
    Params: array[0..3] of DWORD;
    Far: BOOL;
    Virtual: BOOL;
    Reserved: array[0..2] of DWORD;
    KdHelp: KDHELP;
    AddrBStore: ADDRESS;
  end;
const ADDRESS = extern struct {
    Offset: u32,
    Segment: u16,
    Mode: i32,
};

const KDHELP = extern struct {
    Thread: u32,
    ThCallbackStack: u32,
    NextCallback: u32,
    FramePointer: u32,
    KiCallUserMode: u32,
    KeUserCallbackDispatcher: u32,
    SystemRangeStart: u32,
    ThCallbackBStore: u32,
    KiUserExceptionDispatcher: u32,
    StackBase: u32,
    StackLimit: u32,
    Reserved: [5]u32,
};

const STACKFRAME = extern struct {
    AddrPC: ADDRESS,
    AddrReturn: ADDRESS,
    AddrFrame: ADDRESS,
    AddrStack: ADDRESS,
    FuncTableEntry: ?*anyopaque,
    Params: [4]u32,
    Far: i32,
    Virtual: i32,
    Reserved: [3]u32,
    KdHelp: KDHELP,
    AddrBStore: ADDRESS,
};
type
  ADDRESS {.bycopy.} = object
    Offset: uint32
    Segment: uint16
    Mode: int32

  KDHELP {.bycopy.} = object
    Thread: uint32
    ThCallbackStack: uint32
    NextCallback: uint32
    FramePointer: uint32
    KiCallUserMode: uint32
    KeUserCallbackDispatcher: uint32
    SystemRangeStart: uint32
    ThCallbackBStore: uint32
    KiUserExceptionDispatcher: uint32
    StackBase: uint32
    StackLimit: uint32
    Reserved: array[5, uint32]

  STACKFRAME {.bycopy.} = object
    AddrPC: ADDRESS
    AddrReturn: ADDRESS
    AddrFrame: ADDRESS
    AddrStack: ADDRESS
    FuncTableEntry: pointer
    Params: array[4, uint32]
    Far: int32
    Virtual: int32
    Reserved: array[3, uint32]
    KdHelp: KDHELP
    AddrBStore: ADDRESS
struct ADDRESS
{
    uint Offset;
    ushort Segment;
    int Mode;
}

struct KDHELP
{
    uint Thread;
    uint ThCallbackStack;
    uint NextCallback;
    uint FramePointer;
    uint KiCallUserMode;
    uint KeUserCallbackDispatcher;
    uint SystemRangeStart;
    uint ThCallbackBStore;
    uint KiUserExceptionDispatcher;
    uint StackBase;
    uint StackLimit;
    uint[5] Reserved;
}

struct STACKFRAME
{
    ADDRESS AddrPC;
    ADDRESS AddrReturn;
    ADDRESS AddrFrame;
    ADDRESS AddrStack;
    void* FuncTableEntry;
    uint[4] Params;
    int Far;
    int Virtual;
    uint[3] Reserved;
    KDHELP KdHelp;
    ADDRESS AddrBStore;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; STACKFRAME サイズ: 164 バイト(x86)
dim st, 41    ; 4byte整数×41(構造体サイズ 164 / 4 切り上げ)
; AddrPC : ADDRESS (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; AddrReturn : ADDRESS (+12, 12byte)  varptr(st)+12 を基点に操作(12byte:入れ子/配列)
; AddrFrame : ADDRESS (+24, 12byte)  varptr(st)+24 を基点に操作(12byte:入れ子/配列)
; AddrStack : ADDRESS (+36, 12byte)  varptr(st)+36 を基点に操作(12byte:入れ子/配列)
; FuncTableEntry : void* (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; Params : DWORD (+52, 16byte)  varptr(st)+52 を基点に操作(16byte:入れ子/配列)
; Far : BOOL (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; Virtual : BOOL (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; Reserved : DWORD (+76, 12byte)  varptr(st)+76 を基点に操作(12byte:入れ子/配列)
; KdHelp : KDHELP (+88, 64byte)  varptr(st)+88 を基点に操作(64byte:入れ子/配列)
; AddrBStore : ADDRESS (+152, 12byte)  varptr(st)+152 を基点に操作(12byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; STACKFRAME サイズ: 168 バイト(x64)
dim st, 42    ; 4byte整数×42(構造体サイズ 168 / 4 切り上げ)
; AddrPC : ADDRESS (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; AddrReturn : ADDRESS (+12, 12byte)  varptr(st)+12 を基点に操作(12byte:入れ子/配列)
; AddrFrame : ADDRESS (+24, 12byte)  varptr(st)+24 を基点に操作(12byte:入れ子/配列)
; AddrStack : ADDRESS (+36, 12byte)  varptr(st)+36 を基点に操作(12byte:入れ子/配列)
; FuncTableEntry : void* (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; Params : DWORD (+56, 16byte)  varptr(st)+56 を基点に操作(16byte:入れ子/配列)
; Far : BOOL (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; Virtual : BOOL (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; Reserved : DWORD (+80, 12byte)  varptr(st)+80 を基点に操作(12byte:入れ子/配列)
; KdHelp : KDHELP (+92, 64byte)  varptr(st)+92 を基点に操作(64byte:入れ子/配列)
; AddrBStore : ADDRESS (+156, 12byte)  varptr(st)+156 を基点に操作(12byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global ADDRESS
    #field int Offset
    #field short Segment
    #field int Mode
#endstruct

#defstruct global KDHELP
    #field int Thread
    #field int ThCallbackStack
    #field int NextCallback
    #field int FramePointer
    #field int KiCallUserMode
    #field int KeUserCallbackDispatcher
    #field int SystemRangeStart
    #field int ThCallbackBStore
    #field int KiUserExceptionDispatcher
    #field int StackBase
    #field int StackLimit
    #field int Reserved 5
#endstruct

#defstruct global STACKFRAME
    #field ADDRESS AddrPC
    #field ADDRESS AddrReturn
    #field ADDRESS AddrFrame
    #field ADDRESS AddrStack
    #field intptr FuncTableEntry
    #field int Params 4
    #field bool Far
    #field bool Virtual
    #field int Reserved 3
    #field KDHELP KdHelp
    #field ADDRESS AddrBStore
#endstruct

stdim st, STACKFRAME        ; NSTRUCT 変数を確保
st->Far = 100
mes "Far=" + st->Far