Microsoft DirectX 8.0

IRegFilterInfo インターフェイス

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 このフィルタのインスタンスを作成し、それをフィルタ グラフに追加する。

IRegFilterInfo::Filter

IRegFilterInfo インターフェイス

このフィルタのインスタンスを作成し、それをフィルタ グラフに追加する。

構文

HRESULT Filter(

  IDispatch **ppUnk
  );

パラメータ

ppUnk
[out] 追加されたフィルタの IFilterInfo インターフェイスへのポインタのアドレス。

戻り値

HRESULT 値を返す。

注意

IRegFilterInfo インターフェイスの集合に含まれる名前を比較してフィルタを検索するには、IRegFilterInfo::get_Name メソッド (Visual Basic の Name プロパティ) を使用する。

IRegFilterInfo::get_Name

IRegFilterInfo インターフェイス

フィルタ名を取得する。

構文

HRESULT get_Name(

  BSTR *strName
  );

パラメータ

strName
[out, retval] フィルタ名へのポインタ。

戻り値

HRESULT 値を返す。

注意

通常、Visual Basic アプリケーションでは、IRegFilterInfo インターフェイスの集合に For Each...Next 構文を使用して、追加したいフィルタが見つかるまで、レジストリに含まれる個々のフィルタの名前を確認する。次に、IRegFilterInfo::Filter メソッドを使用して、そのフィルタをフィルタ グラフに追加できる。