IComponent
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
IComponent インターフェイスは、IMPEG2Component などのすべての派生インターフェイスの基底クラスであり、program stream 内の elementary stream であるコンポーネントの一般的な特性を記述します。
解説(Remarks)
このインターフェイスのインターフェイス識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IComponent)。
メソッド 9
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
get_Type メソッドは、コンポーネントの一般的な特性を記述する IComponentType インターフェイスを取得します。
| CT | IComponentType** | out | 取得したコンポーネントが設定される IComponentType インターフェイスポインターのアドレス。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
put_Type メソッドは、コンポーネントの一般的な特性を記述する IComponentType オブジェクトを設定します。
| CT | IComponentType* | in | コンポーネントの新しい値を指定する IComponentType オブジェクトへのポインター。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
解説(Remarks)
IComponent 基底クラスインターフェイスを使用する場合、type を NULL に設定できます。派生クラスの IMPEG2Component クラスインターフェイスでこれを行おうとすると、このメソッドは E_POINTER を返します。IMPEG2Component オブジェクトは、設定する type として基底の IComponentType クラスインターフェイスを持つことはできません。この場合、Type Mismatch (0x80020005) を返します。
get_DescLangID メソッドは、description プロパティの言語識別子を取得します。
| LangID | INT* | out | 言語識別子を受け取ります。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
解説(Remarks)
返される言語識別子は、get_Description メソッドの呼び出しによって取得される description プロパティの言語を示します。
ストリームコンテンツの言語を取得するには、ILanguageComponentType::get_LangID メソッドを呼び出します (コンポーネントオブジェクトが ILanguageComponentType インターフェイスを公開している場合のみ)。
put_DescLangID メソッドは、description の表示に使用する言語を設定します。
| LangID | INT | in | 言語 ID を指定します。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
解説(Remarks)
これは、コンポーネントオブジェクト内の説明情報の言語です。ストリームコンテンツの言語を定義する language component type の言語 ID とは異なります。アプリケーションは、別の言語のサブストリームを有効化するためにこの値を変更できます。
get_Status メソッドは、コンポーネントの要求された状態または実際の状態を取得します。
| Status | ComponentStatus* | out | 状態値を受け取る ComponentStatus 列挙体へのポインター。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
解説(Remarks)
TIF がコンポーネントを IComponents コレクションに追加する際、そのコンポーネントがアクティブかどうかを示すことができます。アプリケーションはこの状態の設定を試み、チューン要求を再送信できます。チューナーは、Active、Inactive、Unavailable という列挙体の値で状態を更新します。Unavailable 状態は、アクティブ化の要求に応じて、コンポーネントが実際には利用できない場合にのみチューナーによって設定されます。
put_Status メソッドは、コンポーネントの要求された状態または実際の状態を設定します。
| Status | ComponentStatus | in | 状態値を指定する ComponentStatus 型の変数。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
解説(Remarks)
このメソッドを使用して、ストリームコンポーネントをアクティブ化または非アクティブ化します。
get_Description メソッドは、コンポーネントの description を取得します。
| Description | LPWSTR* | out | description を受け取る変数へのポインター。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
解説(Remarks)
呼び出し元は、SysFreeString を呼び出して、返された BSTR を解放する必要があります。
put_Description メソッドは、コンポーネントの description を設定します。
| Description | LPWSTR | in | 新しい description を含む BSTR 型の変数。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
Clone メソッドは、コンポーネントのコピーを作成します。
| NewComponent | IComponent** | out | IComponent インターフェイスポインターを受け取ります。呼び出し元はインターフェイスを解放する必要があります。 |
戻り値
成功した場合は S_OK を返します。メソッドが失敗した場合、標準の COM IErrorInfo インターフェイスを使用してエラー情報を取得できます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IComponent "{1A5576FC-0E19-11D3-9D8E-00C04F72D980}" #usecom global IComponent IID_IComponent "{59DC47A8-116C-11D3-9D8E-00C04F72D980}" #comfunc global IComponent_get_Type 7 sptr #comfunc global IComponent_put_Type 8 sptr #comfunc global IComponent_get_DescLangID 9 var #comfunc global IComponent_put_DescLangID 10 int #comfunc global IComponent_get_Status 11 var #comfunc global IComponent_put_Status 12 int #comfunc global IComponent_get_Description 13 var #comfunc global IComponent_put_Description 14 wstr #comfunc global IComponent_Clone 15 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IComponent "{1A5576FC-0E19-11D3-9D8E-00C04F72D980}" #usecom global IComponent IID_IComponent "{59DC47A8-116C-11D3-9D8E-00C04F72D980}" #comfunc global IComponent_get_Type 7 sptr #comfunc global IComponent_put_Type 8 sptr #comfunc global IComponent_get_DescLangID 9 sptr #comfunc global IComponent_put_DescLangID 10 int #comfunc global IComponent_get_Status 11 sptr #comfunc global IComponent_put_Status 12 int #comfunc global IComponent_get_Description 13 sptr #comfunc global IComponent_put_Description 14 wstr #comfunc global IComponent_Clone 15 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。