ホーム › System.Com.CallObj › CALLFRAMEINFO

CALLFRAMEINFO

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
iMethod	DWORD	4	+0	+0	対象のインターフェイス内におけるメソッド番号です。
fHasInValues	BOOL	4	+4	+4	メソッドに [in] パラメーターが 1 つ以上ある場合は TRUE、それ以外の場合は FALSE です。
fHasInOutValues	BOOL	4	+8	+8	メソッドに [in, out] パラメーターが 1 つ以上ある場合は TRUE、それ以外の場合は FALSE です。
fHasOutValues	BOOL	4	+12	+12	メソッドに HRESULT または void の戻り値以外の out パラメーターが 1 つ以上ある場合は TRUE、それ以外の場合は FALSE です。
fDerivesFromIDispatch	BOOL	4	+16	+16	インターフェイスが IDispatch から派生している場合は TRUE、それ以外の場合は FALSE です。
cInInterfacesMax	INT	4	+20	+20	このパラメーターの値が 0 以上の場合、その値は [in] インターフェイスの数の絶対的な上限を表します。0 未満の場合、そのメソッドは無制限の数の [in] インターフェイスを持つ可能性があります。0 の場合、[in] インターフェイスはありません。
cInOutInterfacesMax	INT	4	+24	+24	このパラメーターの値が 0 以上の場合、その値は [in, out] インターフェイスの数の絶対的な上限を表します。0 未満の場合、そのメソッドは無制限の数の [in, out] インターフェイスを持つ可能性があります。0 の場合、[in, out] インターフェイスはありません。
cOutInterfacesMax	INT	4	+28	+28	このパラメーターの値が 0 以上の場合、その値は [out] インターフェイスの数の絶対的な上限を表します。0 未満の場合、そのメソッドは無制限の数の [out] インターフェイスを持つ可能性があります。0 の場合、[out] インターフェイスはありません。
cTopLevelInInterfaces	INT	4	+32	+32	インターフェイスポインターである [in] パラメーターの数です。
iid	GUID	16	+36	+36	インターフェイス ID です。
cMethod	DWORD	4	+52	+52	iid 内のメソッドの数です。
cParams	DWORD	4	+56	+56	imethod 内のパラメーターの数です。レシーバーは含まれません。

公式ドキュメント

呼び出しフレーム内のメソッド、[in]・[out]・[in, out] パラメーターの有無、[in]・[out]・[in, out] インターフェイスの数、インターフェイス ID、インターフェイス内のメソッド数、およびこのメソッドのパラメーター数といった、呼び出しフレームに関する情報を提供します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// CALLFRAMEINFO  (x64 60 / x86 60 バイト)
typedef struct CALLFRAMEINFO {
    DWORD iMethod;
    BOOL fHasInValues;
    BOOL fHasInOutValues;
    BOOL fHasOutValues;
    BOOL fDerivesFromIDispatch;
    INT cInInterfacesMax;
    INT cInOutInterfacesMax;
    INT cOutInterfacesMax;
    INT cTopLevelInInterfaces;
    GUID iid;
    DWORD cMethod;
    DWORD cParams;
} CALLFRAMEINFO;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CALLFRAMEINFO
{
    public uint iMethod;
    [MarshalAs(UnmanagedType.Bool)] public bool fHasInValues;
    [MarshalAs(UnmanagedType.Bool)] public bool fHasInOutValues;
    [MarshalAs(UnmanagedType.Bool)] public bool fHasOutValues;
    [MarshalAs(UnmanagedType.Bool)] public bool fDerivesFromIDispatch;
    public int cInInterfacesMax;
    public int cInOutInterfacesMax;
    public int cOutInterfacesMax;
    public int cTopLevelInInterfaces;
    public Guid iid;
    public uint cMethod;
    public uint cParams;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CALLFRAMEINFO
    Public iMethod As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public fHasInValues As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public fHasInOutValues As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public fHasOutValues As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public fDerivesFromIDispatch As Boolean
    Public cInInterfacesMax As Integer
    Public cInOutInterfacesMax As Integer
    Public cOutInterfacesMax As Integer
    Public cTopLevelInInterfaces As Integer
    Public iid As Guid
    Public cMethod As UInteger
    Public cParams As UInteger
End Structure

import ctypes
from ctypes import wintypes

class CALLFRAMEINFO(ctypes.Structure):
    _fields_ = [
        ("iMethod", wintypes.DWORD),
        ("fHasInValues", wintypes.BOOL),
        ("fHasInOutValues", wintypes.BOOL),
        ("fHasOutValues", wintypes.BOOL),
        ("fDerivesFromIDispatch", wintypes.BOOL),
        ("cInInterfacesMax", ctypes.c_int),
        ("cInOutInterfacesMax", ctypes.c_int),
        ("cOutInterfacesMax", ctypes.c_int),
        ("cTopLevelInInterfaces", ctypes.c_int),
        ("iid", GUID),
        ("cMethod", wintypes.DWORD),
        ("cParams", wintypes.DWORD),
    ]

#[repr(C)]
pub struct CALLFRAMEINFO {
    pub iMethod: u32,
    pub fHasInValues: i32,
    pub fHasInOutValues: i32,
    pub fHasOutValues: i32,
    pub fDerivesFromIDispatch: i32,
    pub cInInterfacesMax: i32,
    pub cInOutInterfacesMax: i32,
    pub cOutInterfacesMax: i32,
    pub cTopLevelInInterfaces: i32,
    pub iid: GUID,
    pub cMethod: u32,
    pub cParams: u32,
}

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

type CALLFRAMEINFO struct {
	iMethod uint32
	fHasInValues int32
	fHasInOutValues int32
	fHasOutValues int32
	fDerivesFromIDispatch int32
	cInInterfacesMax int32
	cInOutInterfacesMax int32
	cOutInterfacesMax int32
	cTopLevelInInterfaces int32
	iid windows.GUID
	cMethod uint32
	cParams uint32
}

type
  CALLFRAMEINFO = record
    iMethod: DWORD;
    fHasInValues: BOOL;
    fHasInOutValues: BOOL;
    fHasOutValues: BOOL;
    fDerivesFromIDispatch: BOOL;
    cInInterfacesMax: Integer;
    cInOutInterfacesMax: Integer;
    cOutInterfacesMax: Integer;
    cTopLevelInInterfaces: Integer;
    iid: TGUID;
    cMethod: DWORD;
    cParams: DWORD;
  end;

const CALLFRAMEINFO = extern struct {
    iMethod: u32,
    fHasInValues: i32,
    fHasInOutValues: i32,
    fHasOutValues: i32,
    fDerivesFromIDispatch: i32,
    cInInterfacesMax: i32,
    cInOutInterfacesMax: i32,
    cOutInterfacesMax: i32,
    cTopLevelInInterfaces: i32,
    iid: GUID,
    cMethod: u32,
    cParams: u32,
};

type
  CALLFRAMEINFO {.bycopy.} = object
    iMethod: uint32
    fHasInValues: int32
    fHasInOutValues: int32
    fHasOutValues: int32
    fDerivesFromIDispatch: int32
    cInInterfacesMax: int32
    cInOutInterfacesMax: int32
    cOutInterfacesMax: int32
    cTopLevelInInterfaces: int32
    iid: GUID
    cMethod: uint32
    cParams: uint32

struct CALLFRAMEINFO
{
    uint iMethod;
    int fHasInValues;
    int fHasInOutValues;
    int fHasOutValues;
    int fDerivesFromIDispatch;
    int cInInterfacesMax;
    int cInOutInterfacesMax;
    int cOutInterfacesMax;
    int cTopLevelInInterfaces;
    GUID iid;
    uint cMethod;
    uint cParams;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CALLFRAMEINFO サイズ: 60 バイト(x64)
dim st, 15    ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; iMethod : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; fHasInValues : BOOL (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; fHasInOutValues : BOOL (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; fHasOutValues : BOOL (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; fDerivesFromIDispatch : BOOL (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; cInInterfacesMax : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; cInOutInterfacesMax : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; cOutInterfacesMax : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; cTopLevelInInterfaces : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; iid : GUID (+36, 16byte)  varptr(st)+36 を基点に操作(16byte:入れ子/配列)
; cMethod : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; cParams : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global CALLFRAMEINFO
    #field int iMethod
    #field bool fHasInValues
    #field bool fHasInOutValues
    #field bool fHasOutValues
    #field bool fDerivesFromIDispatch
    #field int cInInterfacesMax
    #field int cInOutInterfacesMax
    #field int cOutInterfacesMax
    #field int cTopLevelInInterfaces
    #field GUID iid
    #field int cMethod
    #field int cParams
#endstruct

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

CALLFRAMEINFO

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義