ホーム › System.Diagnostics.Debug.Extensions › DEBUG_STACK_FRAME

DEBUG_STACK_FRAME

構造体

サイズx64: 128 バイト / x86: 128 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
InstructionOffset	ULONGLONG	8	+0	+0	このフレームの命令ポインタ（IP）のアドレス。
ReturnOffset	ULONGLONG	8	+8	+8	呼び出し元への戻りアドレス。
FrameOffset	ULONGLONG	8	+16	+16	フレームポインタ（FP）のアドレス。
StackOffset	ULONGLONG	8	+24	+24	スタックポインタ（SP）のアドレス。
FuncTableEntry	ULONGLONG	8	+32	+32	関数テーブルエントリへのポインタ値。
Params	ULONGLONG	32	+40	+40	関数の引数領域を示す値（最大4個分）。
Reserved	ULONGLONG	48	+72	+72	予約フィールド（エンジン内部用）。
Virtual	BOOL	4	+120	+120	仮想（インライン）フレームかを示すブール値。
FrameNumber	DWORD	4	+124	+124	スタック内でのフレーム番号（0が最上位）。

各言語での定義

#include <windows.h>

// DEBUG_STACK_FRAME  (x64 128 / x86 128 バイト)
typedef struct DEBUG_STACK_FRAME {
    ULONGLONG InstructionOffset;
    ULONGLONG ReturnOffset;
    ULONGLONG FrameOffset;
    ULONGLONG StackOffset;
    ULONGLONG FuncTableEntry;
    ULONGLONG Params[4];
    ULONGLONG Reserved[6];
    BOOL Virtual;
    DWORD FrameNumber;
} DEBUG_STACK_FRAME;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DEBUG_STACK_FRAME
{
    public ulong InstructionOffset;
    public ulong ReturnOffset;
    public ulong FrameOffset;
    public ulong StackOffset;
    public ulong FuncTableEntry;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public ulong[] Params;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 6)] public ulong[] Reserved;
    [MarshalAs(UnmanagedType.Bool)] public bool Virtual;
    public uint FrameNumber;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DEBUG_STACK_FRAME
    Public InstructionOffset As ULong
    Public ReturnOffset As ULong
    Public FrameOffset As ULong
    Public StackOffset As ULong
    Public FuncTableEntry As ULong
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public Params() As ULong
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=6)> Public Reserved() As ULong
    <MarshalAs(UnmanagedType.Bool)> Public Virtual As Boolean
    Public FrameNumber As UInteger
End Structure

import ctypes
from ctypes import wintypes

class DEBUG_STACK_FRAME(ctypes.Structure):
    _fields_ = [
        ("InstructionOffset", ctypes.c_ulonglong),
        ("ReturnOffset", ctypes.c_ulonglong),
        ("FrameOffset", ctypes.c_ulonglong),
        ("StackOffset", ctypes.c_ulonglong),
        ("FuncTableEntry", ctypes.c_ulonglong),
        ("Params", ctypes.c_ulonglong * 4),
        ("Reserved", ctypes.c_ulonglong * 6),
        ("Virtual", wintypes.BOOL),
        ("FrameNumber", wintypes.DWORD),
    ]

#[repr(C)]
pub struct DEBUG_STACK_FRAME {
    pub InstructionOffset: u64,
    pub ReturnOffset: u64,
    pub FrameOffset: u64,
    pub StackOffset: u64,
    pub FuncTableEntry: u64,
    pub Params: [u64; 4],
    pub Reserved: [u64; 6],
    pub Virtual: i32,
    pub FrameNumber: u32,
}

import "golang.org/x/sys/windows"

type DEBUG_STACK_FRAME struct {
	InstructionOffset uint64
	ReturnOffset uint64
	FrameOffset uint64
	StackOffset uint64
	FuncTableEntry uint64
	Params [4]uint64
	Reserved [6]uint64
	Virtual int32
	FrameNumber uint32
}

type
  DEBUG_STACK_FRAME = record
    InstructionOffset: UInt64;
    ReturnOffset: UInt64;
    FrameOffset: UInt64;
    StackOffset: UInt64;
    FuncTableEntry: UInt64;
    Params: array[0..3] of UInt64;
    Reserved: array[0..5] of UInt64;
    Virtual: BOOL;
    FrameNumber: DWORD;
  end;

const DEBUG_STACK_FRAME = extern struct {
    InstructionOffset: u64,
    ReturnOffset: u64,
    FrameOffset: u64,
    StackOffset: u64,
    FuncTableEntry: u64,
    Params: [4]u64,
    Reserved: [6]u64,
    Virtual: i32,
    FrameNumber: u32,
};

type
  DEBUG_STACK_FRAME {.bycopy.} = object
    InstructionOffset: uint64
    ReturnOffset: uint64
    FrameOffset: uint64
    StackOffset: uint64
    FuncTableEntry: uint64
    Params: array[4, uint64]
    Reserved: array[6, uint64]
    Virtual: int32
    FrameNumber: uint32

struct DEBUG_STACK_FRAME
{
    ulong InstructionOffset;
    ulong ReturnOffset;
    ulong FrameOffset;
    ulong StackOffset;
    ulong FuncTableEntry;
    ulong[4] Params;
    ulong[6] Reserved;
    int Virtual;
    uint FrameNumber;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DEBUG_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,上位
; FuncTableEntry : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; Params : ULONGLONG (+40, 32byte)  varptr(st)+40 を基点に操作(32byte:入れ子/配列)
; Reserved : ULONGLONG (+72, 48byte)  varptr(st)+72 を基点に操作(48byte:入れ子/配列)
; Virtual : BOOL (+120, 4byte)  st.30 = 値  /  値 = st.30   (lpoke/lpeek も可)
; FrameNumber : DWORD (+124, 4byte)  st.31 = 値  /  値 = st.31   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DEBUG_STACK_FRAME
    #field int64 InstructionOffset
    #field int64 ReturnOffset
    #field int64 FrameOffset
    #field int64 StackOffset
    #field int64 FuncTableEntry
    #field int64 Params 4
    #field int64 Reserved 6
    #field bool Virtual
    #field int FrameNumber
#endstruct

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

DEBUG_STACK_FRAME

フィールド

各言語での定義

HSP用 定義

HSP用定義