IFilterMapper2

フィルターの登録と登録解除を行い、レジストリ内のフィルターを検索します。

CreateCategory メソッドは、新しいフィルターカテゴリをレジストリに追加します。

成功した場合は S_OK を返します。失敗した場合は、エラーの原因を示す HRESULT 値を返します。

フィルターグラフマネージャーは、グラフ構築処理を高速化するため、Merit 値が MERIT_DO_NOT_USE 以下のすべてのカテゴリを最初にスキップします。再生の対象とすべきでないフィルターカテゴリには、MERIT_DO_NOT_USE 以下の Merit を設定してください。

フィルターは、検索空間を絞り込むために、1 つ以上のカテゴリ (たとえば Video Compressors) に属することができます。

UnregisterFilter メソッドは、フィルター情報をレジストリから削除します。

成功した場合は S_OK を返します。失敗した場合は、エラーの原因を示す HRESULT 値を返します。

フィルターが登録されていなかった場合、このメソッドはエラーを返すことがあります。

RegisterFilter メソッドは、フィルター情報をレジストリに追加します。

HRESULT 値を返します。取り得る値には、次の表に示すものがあります。

このメソッドは、指定されたフィルターカテゴリのレジストリエントリの下に、フィルターに関する情報をレジストリに追加します。フィルターを作成するインプロセスサーバー (通常は DLL) は登録しません。サーバーを登録するには、AMovieDllRegisterServer2 関数を呼び出します。

ppMoniker パラメーターには、次のいずれかを使用します。

• 既存のデバイスモニカーに対する IMoniker インターフェイスポインターのアドレス
• NULL の IMoniker インターフェイスポインターのアドレス
• NULL

それ以外の場合、メソッドは新しいモニカーを作成します。ppMoniker が非 NULL の場合、メソッドは *ppMoniker が新しいモニカーを指すように設定します。アプリケーションはこのモニカーを使用して、プロパティバッグに追加のプライベートな値を書き込むことができます。インターフェイスは必ず解放してください。

モニカーの提供も受け取りも行わない場合は、ppMoniker を NULL に設定してください。

EnumMatchingFilters メソッドは、指定された要件を満たす登録済みフィルターを列挙します。

HRESULT 値を返します。取り得る値には、次の表に示すものがあります。

入力ピンが指定された一連のメディアタイプに一致するフィルターを見つけるには、メジャータイプの GUID とサブタイプの GUID をペアで並べた配列を宣言します。配列のアドレスを pInputTypes パラメーターに渡し、cInputTypes パラメーターにはペアの数 (つまり配列サイズの半分) を設定します。

GUID arrayInTypes[2];
arrayInTypes[0] = MEDIATYPE_Video;
arrayInTypes[1] = GUID_NULL;

DWORD cInTypes = 1;

bExactMatch パラメーターの値が TRUE の場合、このメソッドは、メディアタイプ、ピンカテゴリ、ピンメディウムに指定した値と完全に一致するフィルターを検索します。値が FALSE の場合、これらの項目のいずれかに NULL 値を登録しているフィルターも一致とみなされます。(実質的に、レジストリ内の NULL 値はワイルドカードとして機能します。)

メディアタイプ、ピンカテゴリ、ピンメディウムに NULL を指定した場合、そのパラメーターについてはすべてのフィルターが一致とみなされます。

ピンがメディアタイプをまったく登録していなかった場合、このメソッドはそのピンをメディアタイプの一致とはみなしません。