Win32 API 日本語リファレンス
ホームMedia.DirectShow › IFilterInfo

IFilterInfo

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID56a868ba-0ad4-11ce-b03a-0020af0ba770継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 8

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT FindPin(LPWSTR strPinID, IDispatch** ppUnk)
strPinIDLPWSTRin検索する対象ピンの識別子(ピンID)を渡す入力引数。
ppUnkIDispatch**out見つかったピンのIDispatchポインタを受け取る出力ポインタ。使用後にReleaseが必要。
vtbl 8 HRESULT get_Name(LPWSTR* strName)
strNameLPWSTR*outフィルタの名称を受け取る出力ポインタ。呼出側が解放する。
vtbl 9 HRESULT get_VendorInfo(LPWSTR* strVendorInfo)
strVendorInfoLPWSTR*outフィルタのベンダー情報を受け取る出力ポインタ。呼出側が解放する。
vtbl 10 HRESULT get_Filter(IUnknown** ppUnk)
ppUnkIUnknown**out対応するフィルタオブジェクトのIUnknownポインタを受け取る出力ポインタ。使用後にReleaseが必要。
vtbl 11 HRESULT get_Pins(IDispatch** ppUnk)
ppUnkIDispatch**outフィルタのピンコレクションを表すIDispatchポインタを受け取る出力ポインタ。使用後にReleaseが必要。
vtbl 12 HRESULT get_IsFileSource(INT* pbIsSource)
pbIsSourceINT*outこのフィルタがファイルソースかどうかを受け取る出力ポインタ。
vtbl 13 HRESULT get_Filename(LPWSTR* pstrFilename)
pstrFilenameLPWSTR*outソースファイルのパスを受け取る出力ポインタ。呼出側が解放する。
vtbl 14 HRESULT put_Filename(LPWSTR strFilename)
strFilenameLPWSTRin設定するソースファイルのパスを渡す入力引数。

HSP用 COM定義

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

出力引数:
#define global IID_IFilterInfo "{56A868BA-0AD4-11CE-B03A-0020AF0BA770}"
#usecom global IFilterInfo IID_IFilterInfo "{}"
#comfunc global IFilterInfo_FindPin           7 wstr,sptr
#comfunc global IFilterInfo_get_Name          8 var
#comfunc global IFilterInfo_get_VendorInfo    9 var
#comfunc global IFilterInfo_get_Filter        10 sptr
#comfunc global IFilterInfo_get_Pins          11 sptr
#comfunc global IFilterInfo_get_IsFileSource  12 var
#comfunc global IFilterInfo_get_Filename      13 var
#comfunc global IFilterInfo_put_Filename      14 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。