ITypeMarshal

COM

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

メソッド 4

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

vtbl 3 HRESULT Size(void* pvType, DWORD dwDestContext, void* pvDestContext, DWORD* pSize)

pvType	void*	in	マーシャリングするデータインスタンスへのポインタを指定する。
dwDestContext	DWORD	in	マーシャリング先のコンテキスト(MSHCTX 値)を指定する。
pvDestContext	void*	in	マーシャリング先コンテキストに固有のデータへのポインタを指定する。通常は NULL を指定する。
pSize	DWORD*	out	マーシャリングに必要なバッファのバイト数を受け取る。

vtbl 4 HRESULT Marshal(void* pvType, DWORD dwDestContext, void* pvDestContext, DWORD cbBufferLength, BYTE* pBuffer, DWORD* pcbWritten)

pvType	void*	in	マーシャリングするデータインスタンスへのポインタを指定する。
dwDestContext	DWORD	in	マーシャリング先のコンテキスト(MSHCTX 値)を指定する。
pvDestContext	void*	in	マーシャリング先コンテキストに固有のデータへのポインタを指定する。通常は NULL を指定する。
cbBufferLength	DWORD	in	pBuffer が指すバッファのバイト数を指定する。
pBuffer	BYTE*	out	マーシャリングされたデータを書き込むバッファへのポインタを指定する。
pcbWritten	DWORD*	out	バッファへ書き込まれたバイト数を受け取る。

vtbl 5 HRESULT Unmarshal(void* pvType, DWORD dwFlags, DWORD cbBufferLength, BYTE* pBuffer, DWORD* pcbRead)

pvType	void*	out	アンマーシャリングしたデータを受け取るインスタンスへのポインタを指定する。
dwFlags	DWORD	in	アンマーシャリングの動作を制御するフラグを指定する。
cbBufferLength	DWORD	in	pBuffer が指すバッファのバイト数を指定する。
pBuffer	BYTE*	in	アンマーシャリングするデータを含むバッファへのポインタを指定する。
pcbRead	DWORD*	out	バッファから読み取られたバイト数を受け取る。

vtbl 6 HRESULT Free(void* pvType)

pvType

void*

解放するデータインスタンスへのポインタを指定する。

HSP用 COM定義

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

出力引数:

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