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

IMAGEHLP_STACK_FRAME

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

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

フィールド

フィールドサイズx64x86説明
InstructionOffsetULONGLONG8+0+0命令ポインタ(PC)のオフセットを示す。
ReturnOffsetULONGLONG8+8+8リターンアドレスのオフセットを示す。
FrameOffsetULONGLONG8+16+16フレームポインタのオフセットを示す。
StackOffsetULONGLONG8+24+24スタックポインタのオフセットを示す。
BackingStoreOffsetULONGLONG8+32+32バッキングストアのオフセットを示す。主に Itanium 用。
FuncTableEntryULONGLONG8+40+40関数テーブルエントリのアドレスを示す。
ParamsULONGLONG32+48+48関数の引数値(最初の4つ)を保持する配列。
ReservedULONGLONG40+80+80予約フィールド配列。使用しない。
VirtualBOOL4+120+120仮想フレームかどうかを示すフラグ。
Reserved2DWORD4+124+124予約フィールド。使用しない。

各言語での定義

#include <windows.h>

// IMAGEHLP_STACK_FRAME  (x64 128 / x86 128 バイト)
typedef struct IMAGEHLP_STACK_FRAME {
    ULONGLONG InstructionOffset;
    ULONGLONG ReturnOffset;
    ULONGLONG FrameOffset;
    ULONGLONG StackOffset;
    ULONGLONG BackingStoreOffset;
    ULONGLONG FuncTableEntry;
    ULONGLONG Params[4];
    ULONGLONG Reserved[5];
    BOOL Virtual;
    DWORD Reserved2;
} IMAGEHLP_STACK_FRAME;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IMAGEHLP_STACK_FRAME
{
    public ulong InstructionOffset;
    public ulong ReturnOffset;
    public ulong FrameOffset;
    public ulong StackOffset;
    public ulong BackingStoreOffset;
    public ulong FuncTableEntry;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public ulong[] Params;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 5)] public ulong[] Reserved;
    [MarshalAs(UnmanagedType.Bool)] public bool Virtual;
    public uint Reserved2;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IMAGEHLP_STACK_FRAME
    Public InstructionOffset As ULong
    Public ReturnOffset As ULong
    Public FrameOffset As ULong
    Public StackOffset As ULong
    Public BackingStoreOffset As ULong
    Public FuncTableEntry As ULong
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public Params() As ULong
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=5)> Public Reserved() As ULong
    <MarshalAs(UnmanagedType.Bool)> Public Virtual As Boolean
    Public Reserved2 As UInteger
End Structure
import ctypes
from ctypes import wintypes

class IMAGEHLP_STACK_FRAME(ctypes.Structure):
    _fields_ = [
        ("InstructionOffset", ctypes.c_ulonglong),
        ("ReturnOffset", ctypes.c_ulonglong),
        ("FrameOffset", ctypes.c_ulonglong),
        ("StackOffset", ctypes.c_ulonglong),
        ("BackingStoreOffset", ctypes.c_ulonglong),
        ("FuncTableEntry", ctypes.c_ulonglong),
        ("Params", ctypes.c_ulonglong * 4),
        ("Reserved", ctypes.c_ulonglong * 5),
        ("Virtual", wintypes.BOOL),
        ("Reserved2", wintypes.DWORD),
    ]
#[repr(C)]
pub struct IMAGEHLP_STACK_FRAME {
    pub InstructionOffset: u64,
    pub ReturnOffset: u64,
    pub FrameOffset: u64,
    pub StackOffset: u64,
    pub BackingStoreOffset: u64,
    pub FuncTableEntry: u64,
    pub Params: [u64; 4],
    pub Reserved: [u64; 5],
    pub Virtual: i32,
    pub Reserved2: u32,
}
import "golang.org/x/sys/windows"

type IMAGEHLP_STACK_FRAME struct {
	InstructionOffset uint64
	ReturnOffset uint64
	FrameOffset uint64
	StackOffset uint64
	BackingStoreOffset uint64
	FuncTableEntry uint64
	Params [4]uint64
	Reserved [5]uint64
	Virtual int32
	Reserved2 uint32
}
type
  IMAGEHLP_STACK_FRAME = record
    InstructionOffset: UInt64;
    ReturnOffset: UInt64;
    FrameOffset: UInt64;
    StackOffset: UInt64;
    BackingStoreOffset: UInt64;
    FuncTableEntry: UInt64;
    Params: array[0..3] of UInt64;
    Reserved: array[0..4] of UInt64;
    Virtual: BOOL;
    Reserved2: DWORD;
  end;
const IMAGEHLP_STACK_FRAME = extern struct {
    InstructionOffset: u64,
    ReturnOffset: u64,
    FrameOffset: u64,
    StackOffset: u64,
    BackingStoreOffset: u64,
    FuncTableEntry: u64,
    Params: [4]u64,
    Reserved: [5]u64,
    Virtual: i32,
    Reserved2: u32,
};
type
  IMAGEHLP_STACK_FRAME {.bycopy.} = object
    InstructionOffset: uint64
    ReturnOffset: uint64
    FrameOffset: uint64
    StackOffset: uint64
    BackingStoreOffset: uint64
    FuncTableEntry: uint64
    Params: array[4, uint64]
    Reserved: array[5, uint64]
    Virtual: int32
    Reserved2: uint32
struct IMAGEHLP_STACK_FRAME
{
    ulong InstructionOffset;
    ulong ReturnOffset;
    ulong FrameOffset;
    ulong StackOffset;
    ulong BackingStoreOffset;
    ulong FuncTableEntry;
    ulong[4] Params;
    ulong[5] Reserved;
    int Virtual;
    uint Reserved2;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; IMAGEHLP_STACK_FRAME サイズ: 128 バイト(x64)
dim st, 32    ; 4byte整数×32(構造体サイズ 128 / 4 切り上げ)
; InstructionOffset : ULONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; ReturnOffset : ULONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; FrameOffset : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; StackOffset : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; BackingStoreOffset : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; FuncTableEntry : ULONGLONG (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; Params : ULONGLONG (+48, 32byte)  varptr(st)+48 を基点に操作(32byte:入れ子/配列)
; Reserved : ULONGLONG (+80, 40byte)  varptr(st)+80 を基点に操作(40byte:入れ子/配列)
; Virtual : BOOL (+120, 4byte)  st.30 = 値  /  値 = st.30   (lpoke/lpeek も可)
; Reserved2 : DWORD (+124, 4byte)  st.31 = 値  /  値 = st.31   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global IMAGEHLP_STACK_FRAME
    #field int64 InstructionOffset
    #field int64 ReturnOffset
    #field int64 FrameOffset
    #field int64 StackOffset
    #field int64 BackingStoreOffset
    #field int64 FuncTableEntry
    #field int64 Params 4
    #field int64 Reserved 5
    #field bool Virtual
    #field int Reserved2
#endstruct

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