Microsoft DirectX 8.0

IAMovieSetup インターフェイス

注 :  このインターフェイスの使用は避けること。このインターフェイスは、以前のバージョンにおける AMovieDllRegisterServer および AMovieDllUnregisterServer という 2 つの関数で使用されていた。これらの関数に代わって現在は AMovieDllRegisterServer2 が使用されており、この関数は IAMovieSetup を必要としない。ただし、IAMovieSetup は、既存のアプリケーションとの後方互換性を保つために、継続してサポートされる。

Microsoft® ActiveMovie® 1.0 では、フィルタは次に示す自己レジストリ登録を実装していた。

上に示したように、現在は AMovieDllRegisterServer2 関数を使用すべきである。この関数で登録されるフィルタは、IAMovieSetup を実装する必要はない。詳細については、「DirectShow オブジェクトの登録方法」を参照すること。

vtable 順のメソッド

IUnknown メソッド説明
QueryInterface サポートされているインターフェイスへのポインタを取得する。
AddRef 参照カウントをインクリメントする。
Release 参照カウントをデクリメントする。
IAMovieSetup メソッド説明
Register レジストリにフィルタを追加する。
Unregister レジストリからフィルタを削除する。

IAMovieSetup::Register

IAMovieSetup インターフェイス

レジストリにフィルタを追加する。

構文

HRESULT Register(void);

戻り値

実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。
E_FAIL失敗。
E_POINTERNull ポインタ引数。
E_INVALIDARG無効な引数。
E_NOTIMPLメソッドがサポートされていない。
S_OK または NOERROR成功。

注意

このメソッドは、フィルタ、そのピン、およびピンに関連付けられているメディア タイプを登録する。これを行うためには、IFilterMapper メソッドを使用するように実装する必要がある。その実装については、「CBaseFilter::Register」メンバ関数を参照すること。

IAMovieSetup::Unregister

IAMovieSetup インターフェイス

レジストリからフィルタを削除する。

構文

HRESULT Unregister(void);

戻り値

実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。
E_FAIL失敗。
E_POINTERNull ポインタ引数。
E_INVALIDARG無効な引数。
E_NOTIMPLメソッドがサポートされていない。
S_OK または NOERROR成功。

注意

このメソッドでレジストリからフィルタを削除するには、IFilterMapper::UnregisterFilter メソッドを使用するようにこのメソッドを実装する必要がある。このメソッドは、ピンとメディア タイプも効率よく削除する。