Microsoft DirectX 8.0 |
注 : このインターフェイスの使用は避けること。このインターフェイスは、以前のバージョンにおける AMovieDllRegisterServer および AMovieDllUnregisterServer という 2 つの関数で使用されていた。これらの関数に代わって現在は AMovieDllRegisterServer2 が使用されており、この関数は IAMovieSetup を必要としない。ただし、IAMovieSetup は、既存のアプリケーションとの後方互換性を保つために、継続してサポートされる。
Microsoft® ActiveMovie® 1.0 では、フィルタは次に示す自己レジストリ登録を実装していた。
上に示したように、現在は AMovieDllRegisterServer2 関数を使用すべきである。この関数で登録されるフィルタは、IAMovieSetup を実装する必要はない。詳細については、「DirectShow オブジェクトの登録方法」を参照すること。
vtable 順のメソッド
IUnknown メソッド 説明 QueryInterface サポートされているインターフェイスへのポインタを取得する。 AddRef 参照カウントをインクリメントする。 Release 参照カウントをデクリメントする。 IAMovieSetup メソッド 説明 Register レジストリにフィルタを追加する。 Unregister レジストリからフィルタを削除する。
レジストリにフィルタを追加する。
構文
HRESULT Register(void);
戻り値
実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。
E_FAIL 失敗。 E_POINTER Null ポインタ引数。 E_INVALIDARG 無効な引数。 E_NOTIMPL メソッドがサポートされていない。 S_OK または NOERROR 成功。
注意
このメソッドは、フィルタ、そのピン、およびピンに関連付けられているメディア タイプを登録する。これを行うためには、IFilterMapper メソッドを使用するように実装する必要がある。その実装については、「CBaseFilter::Register」メンバ関数を参照すること。
レジストリからフィルタを削除する。
構文
HRESULT Unregister(void);
戻り値
実装に応じた HRESULT 値を返す。HRESULT は、次の標準的な定数の 1 つか、または一覧に示されていないその他の値となる。
E_FAIL 失敗。 E_POINTER Null ポインタ引数。 E_INVALIDARG 無効な引数。 E_NOTIMPL メソッドがサポートされていない。 S_OK または NOERROR 成功。
注意
このメソッドでレジストリからフィルタを削除するには、IFilterMapper::UnregisterFilter メソッドを使用するようにこのメソッドを実装する必要がある。このメソッドは、ピンとメディア タイプも効率よく削除する。