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

IAMPluginControl

COM
📘 Microsoft Learn (日本語) · English
IID0e26a181-f40c-4635-8786-976284b52981継承元IUnknown自前メソッド開始 vtbl3

メソッド 7

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

vtbl 3 HRESULT GetPreferredClsid(GUID* subType, GUID* clsid)
subTypeGUID*in対象とするメディアサブタイプのGUID。
clsidGUID*outそのサブタイプに対する優先フィルタのCLSIDを受け取る出力先。
vtbl 4 HRESULT GetPreferredClsidByIndex(DWORD index, GUID* subType, GUID* clsid)
indexDWORDin列挙する優先設定のインデックス(0起点)。
subTypeGUID*out該当インデックスのメディアサブタイプGUIDを受け取る出力先。
clsidGUID*out該当インデックスの優先フィルタCLSIDを受け取る出力先。
vtbl 5 HRESULT SetPreferredClsid(GUID* subType, GUID* clsid)
subTypeGUID*in優先フィルタを設定するメディアサブタイプのGUID。
clsidGUID*inoptionalそのサブタイプに使う優先フィルタのCLSID。GUID_NULLで設定解除。
vtbl 6 HRESULT IsDisabled(GUID* clsid)
clsidGUID*in無効化されているか判定するフィルタのCLSID。S_OKで無効。
vtbl 7 HRESULT GetDisabledByIndex(DWORD index, GUID* clsid)
indexDWORDin無効化フィルタ一覧の列挙インデックス(0起点)。
clsidGUID*out該当インデックスの無効化フィルタCLSIDを受け取る出力先。
vtbl 8 HRESULT SetDisabled(GUID* clsid, BOOL disabled)
clsidGUID*in有効・無効を切り替えるフィルタのCLSID。
disabledBOOLin無効化するか。TRUEで自動グラフ構築から除外する。
vtbl 9 HRESULT IsLegacyDisabled(LPWSTR dllName)
dllNameLPWSTRin無効化判定するレガシーDLLの名前(ワイド文字列)。

HSP用 COM定義

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

出力引数: 
#define global IID_IAMPluginControl "{0E26A181-F40C-4635-8786-976284B52981}"
#usecom global IAMPluginControl IID_IAMPluginControl "{}"
#comfunc global IAMPluginControl_GetPreferredClsid         3 var,var
#comfunc global IAMPluginControl_GetPreferredClsidByIndex  4 int,var,var
#comfunc global IAMPluginControl_SetPreferredClsid         5 var,var
#comfunc global IAMPluginControl_IsDisabled                6 var
#comfunc global IAMPluginControl_GetDisabledByIndex        7 int,var
#comfunc global IAMPluginControl_SetDisabled               8 var,int
#comfunc global IAMPluginControl_IsLegacyDisabled          9 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。