IMFTopologyServiceLookupClient
COM公式ドキュメント
ビデオミキサーまたはプレゼンターを初期化します。
解説(Remarks)
EVR がビデオミキサーおよびビデオプレゼンターを読み込む際、EVR はこのインターフェイスをオブジェクトに照会し、InitServicePointers を呼び出します。InitServicePointers メソッド内で、オブジェクトは EVR にインターフェイスポインターを照会できます。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ミキサーまたはプレゼンターに対して、拡張ビデオレンダラー (EVR) にインターフェイスポインターを照会するよう通知します。
| pLookup | IMFTopologyServiceLookup* | in | IMFTopologyServiceLookup インターフェイスへのポインターです。EVR にインターフェイスを照会するには、IMFTopologyServiceLookup::LookupService を呼び出します。 |
戻り値
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
IMFTopologyServiceLookup ポインターは、InitServicePointers の呼び出し中に限り有効であることが保証されます。ミキサーまたはプレゼンターは、メソッドが戻った後にこのインターフェイスへのポインターを保持しないでください。
EVR が IMFTopologyServiceLookupClient::ReleaseServicePointers を呼び出したときは、ミキサーまたはプレゼンターは EVR から取得したすべてのポインターを解放する必要があります。
拡張ビデオレンダラー (EVR) から取得したインターフェイスポインターを解放するよう、オブジェクトに通知します。
戻り値
このメソッドは HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 |
解説(Remarks)
このメソッドが呼び出された後は、直前の IMFTopologyServiceLookupClient::InitServicePointers の呼び出し中に取得したインターフェイスポインターは無効になります。オブジェクトはそれらを解放する必要があります。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMFTopologyServiceLookupClient "{FA99388A-4383-415A-A930-DD472A8CF6F7}"
#usecom global IMFTopologyServiceLookupClient IID_IMFTopologyServiceLookupClient "{}"
#comfunc global IMFTopologyServiceLookupClient_InitServicePointers 3 sptr
#comfunc global IMFTopologyServiceLookupClient_ReleaseServicePointers 4
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。