IMarshal

COM

IID00000003-0000-0000-c000-000000000046継承元IUnknown自前メソッド開始 vtbl3

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetUnmarshalClass(GUID* riid, void* pv, DWORD dwDestContext, void* pvDestContext, DWORD mshlflags, GUID* pCid)

riid	GUID*	in	マーシャリングするインターフェイスの GUID(IID)を指定する。
pv	void*	inoptional	マーシャリング対象のインターフェイスポインタを指定する。NULL も指定できる。
dwDestContext	DWORD	in	マーシャリング先の実行コンテキスト(MSHCTX 値)を指定する。
pvDestContext	void*	optional	宛先コンテキストに関する予約済みパラメータであり、NULL を指定する。
mshlflags	DWORD	in	マーシャリングの目的を示すフラグ(MSHLFLAGS 値)を指定する。
pCid	GUID*	out	アンマーシャリングに使用するプロキシクラスの CLSID を受け取る。

vtbl 4 HRESULT GetMarshalSizeMax(GUID* riid, void* pv, DWORD dwDestContext, void* pvDestContext, DWORD mshlflags, DWORD* pSize)

riid	GUID*	in	マーシャリングするインターフェイスの GUID(IID)を指定する。
pv	void*	inoptional	マーシャリング対象のインターフェイスポインタを指定する。NULL も指定できる。
dwDestContext	DWORD	in	マーシャリング先の実行コンテキスト(MSHCTX 値)を指定する。
pvDestContext	void*	optional	宛先コンテキストに関する予約済みパラメータであり、NULL を指定する。
mshlflags	DWORD	in	マーシャリングの目的を示すフラグ(MSHLFLAGS 値)を指定する。
pSize	DWORD*	out	マーシャルデータの格納に必要なバイト数の最大値を受け取る。

vtbl 5 HRESULT MarshalInterface(IStream* pStm, GUID* riid, void* pv, DWORD dwDestContext, void* pvDestContext, DWORD mshlflags)

pStm	IStream*	in	マーシャルデータを書き込む先の IStream ストリームへのポインタである。
riid	GUID*	in	マーシャリングするインターフェイスの GUID(IID)を指定する。
pv	void*	inoptional	マーシャリング対象のインターフェイスポインタを指定する。
dwDestContext	DWORD	in	マーシャリング先の実行コンテキスト(MSHCTX 値)を指定する。
pvDestContext	void*	optional	宛先コンテキストに関する予約済みパラメータであり、NULL を指定する。
mshlflags	DWORD	in	マーシャリングの目的を示すフラグ(MSHLFLAGS 値)を指定する。

vtbl 6 HRESULT UnmarshalInterface(IStream* pStm, GUID* riid, void** ppv)

pStm	IStream*	in	マーシャルデータを読み込む元の IStream ストリームへのポインタである。
riid	GUID*	in	アンマーシャリングして取得するインターフェイスの GUID(IID)を指定する。
ppv	void**	out	アンマーシャリングされたインターフェイスへのポインタを受け取る。

vtbl 7 HRESULT ReleaseMarshalData(IStream* pStm)

pStm

IStream*

解放するマーシャルデータが格納された IStream ストリームへのポインタである。

vtbl 8 HRESULT DisconnectObject(DWORD dwReserved)

dwReserved

DWORD

予約済みパラメータであり、0 を指定する。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IMarshal "{00000003-0000-0000-C000-000000000046}"
#usecom global IMarshal IID_IMarshal "{}"
#comfunc global IMarshal_GetUnmarshalClass   3 var,sptr,int,sptr,int,var
#comfunc global IMarshal_GetMarshalSizeMax   4 var,sptr,int,sptr,int,var
#comfunc global IMarshal_MarshalInterface    5 sptr,var,sptr,int,sptr,int
#comfunc global IMarshal_UnmarshalInterface  6 sptr,var,sptr
#comfunc global IMarshal_ReleaseMarshalData  7 sptr
#comfunc global IMarshal_DisconnectObject    8 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IMarshal "{00000003-0000-0000-C000-000000000046}"
#usecom global IMarshal IID_IMarshal "{}"
#comfunc global IMarshal_GetUnmarshalClass   3 sptr,sptr,int,sptr,int,sptr
#comfunc global IMarshal_GetMarshalSizeMax   4 sptr,sptr,int,sptr,int,sptr
#comfunc global IMarshal_MarshalInterface    5 sptr,sptr,sptr,int,sptr,int
#comfunc global IMarshal_UnmarshalInterface  6 sptr,sptr,sptr
#comfunc global IMarshal_ReleaseMarshalData  7 sptr
#comfunc global IMarshal_DisconnectObject    8 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。