IMSVidGraphSegmentContainer
COM公式ドキュメント
IMSVidGraphSegmentContainer インターフェースは Video Control によって公開され、Filter Graph Manager へのポインターを取得する get_Graph という 1 つのサポートされたメソッドを備えています。
解説(Remarks)
このインターフェースには、ここに示すもの以外にも追加のメソッドがありますが、それらはサポートされていません。
このインターフェースのインターフェース識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IMSVidGraphSegmentContainer)。
メソッド 11
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
get_Graph メソッドは、Filter Graph Manager へのポインターを返します。
| ppGraph | IGraphBuilder** | out | IGraphBuilder インターフェースポインターを受け取る変数のアドレスです。 |
戻り値
成功した場合は S_OK を返し、それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
オブジェクトはこのメソッドを使用して、フィルターグラフ内の特定の DirectShow フィルターを見つけることができます。アプリケーションがこのメソッドを使用することは推奨されません。アプリケーションは常に Video Control を使用してフィルターグラフを制御すべきです。
返される IGraphBuilder インターフェースには未解放の参照カウントがあります。呼び出し側はこのインターフェースを解放する必要があります。
Examples
CComQIPtr<IMSVidGraphSegmentContainer> pSeg(m_pVideoControl);
if (pSeg)
{
CComPtr<IGraphBuilder> pGraph;
hr = pSeg->get_Graph(&pGraph);
if (SUCCEEDED(hr))
{
// Use IGraphBuilder::EnumFilters to enumerate the filters.
}
}
| ppInput | IMSVidGraphSegment** | out | 入力グラフセグメントのIMSVidGraphSegmentポインタを受け取る出力。 |
| ppOutputs | IEnumMSVidGraphSegment** | out | 出力セグメント群を列挙するIEnumMSVidGraphSegmentポインタを受け取る出力。 |
| ppVR | IMSVidGraphSegment** | out | ビデオレンダラーセグメントのIMSVidGraphSegmentポインタを受け取る出力。 |
| ppAR | IMSVidGraphSegment** | out | オーディオレンダラーセグメントのIMSVidGraphSegmentポインタを受け取る出力。 |
| ppFeatures | IEnumMSVidGraphSegment** | out | 機能セグメント群を列挙するIEnumMSVidGraphSegmentポインタを受け取る出力。 |
| ppComposites | IEnumMSVidGraphSegment** | out | 合成セグメント群を列挙するIEnumMSVidGraphSegmentポインタを受け取る出力。 |
| ppContainer | IUnknown** | out | 親コンテナのIUnknownポインタを受け取る出力。 |
| pSegment | IMSVidGraphSegment* | inoptional | コンテナから分解・除去する対象のIMSVidGraphSegmentポインタ。 |
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMSVidGraphSegmentContainer "{3DD2903D-E0AA-11D2-B63A-00C04F79498E}"
#usecom global IMSVidGraphSegmentContainer IID_IMSVidGraphSegmentContainer "{}"
#comfunc global IMSVidGraphSegmentContainer_get_Graph 3 sptr
#comfunc global IMSVidGraphSegmentContainer_get_Input 4 sptr
#comfunc global IMSVidGraphSegmentContainer_get_Outputs 5 sptr
#comfunc global IMSVidGraphSegmentContainer_get_VideoRenderer 6 sptr
#comfunc global IMSVidGraphSegmentContainer_get_AudioRenderer 7 sptr
#comfunc global IMSVidGraphSegmentContainer_get_Features 8 sptr
#comfunc global IMSVidGraphSegmentContainer_get_Composites 9 sptr
#comfunc global IMSVidGraphSegmentContainer_get_ParentContainer 10 sptr
#comfunc global IMSVidGraphSegmentContainer_Decompose 11 sptr
#comfunc global IMSVidGraphSegmentContainer_IsWindowless 12
#comfunc global IMSVidGraphSegmentContainer_GetFocus 13
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。