Microsoft DirectX 8.0 |
Windows® レジストリにあるフィルタへのアクセスを提供し、登録済みフィルタをフィルタ グラフに追加する。
フィルタ グラフ マネージャは、Microsoft® Visual Basic® アプリケーションからの使用を目的に、このインターフェイスを実装する。C/C++ アプリケーションでは、このインターフェイスではなく、IFilterMapper2 インターフェイスを使用すること。
IMediaControl::get_RegFilterCollection メソッドは、IRegFilterInfo インターフェイスの集合を返す。このインターフェイスを使用して、集合に含まれるフィルタの名前を照会し、フィルタ グラフに希望のフィルタを追加する。
vtable 順のメソッド
IUnknown メソッド 説明 QueryInterface サポートされているインターフェイスへのポインタを返す。 AddRef 参照カウントをインクリメントする。 Release 参照カウントをデクリメントする。 IDispatch メソッド 説明 GetTypeInfoCount このディスプインターフェイスに利用可能なタイプ情報があるかどうか判断する。 GetTypeInfo GetTypeInfoCount が成功した場合は、このディスプインターフェイスのタイプ情報を取得する。 GetIDsOfNames (引数を含む) プロパティおよびメソッドのテキスト名を対応する DISPID に変換する。 Invoke DISPID およびその他の必要なパラメータが指定された場合は、このディスプインターフェイスのメソッドを呼び出すか、またはプロパティにアクセスする。 IRegFilterInfo メソッド 説明 get_Name フィルタ名を取得する。 Filter このフィルタのインスタンスを作成し、それをフィルタ グラフに追加する。
このフィルタのインスタンスを作成し、それをフィルタ グラフに追加する。
構文
HRESULT Filter(
IDispatch **ppUnk
);
パラメータ
- ppUnk
- [out] 追加されたフィルタの IFilterInfo インターフェイスへのポインタのアドレス。
戻り値
HRESULT 値を返す。
注意
IRegFilterInfo インターフェイスの集合に含まれる名前を比較してフィルタを検索するには、IRegFilterInfo::get_Name メソッド (Visual Basic の Name プロパティ) を使用する。
フィルタ名を取得する。
構文
HRESULT get_Name(
BSTR *strName
);
パラメータ
- strName
- [out, retval] フィルタ名へのポインタ。
戻り値
HRESULT 値を返す。
注意
通常、Visual Basic アプリケーションでは、IRegFilterInfo インターフェイスの集合に
For Each...Next
構文を使用して、追加したいフィルタが見つかるまで、レジストリに含まれる個々のフィルタの名前を確認する。次に、IRegFilterInfo::Filter メソッドを使用して、そのフィルタをフィルタ グラフに追加できる。