IFilterMapper2::CreateCategory
CreateCategory メソッドは、レジストリに新しいフィルタ カテゴリを追加する。
構文
HRESULT CreateCategory(
REFCLSID clsidCategory,
DWORD dwCategoryMerit,
LPCWSTR Description
);
パラメータ
clsidCategory
[in] 新しいフィルタ カテゴリのクラス識別子 (CLSID)。
dwCategoryMerit
[in] カテゴリのメリット値。メリット値の高いカテゴリほど先に列挙される。
Description
[in] カテゴリの内容を表すわかりやすい名前。
戻り値
成功した場合は S_OK を返す。それ以外の場合は、エラーの発生を示す HRESULT 値を返す。
注意
フィルタ グラフ マネージャは、まず MERIT_DO_NOT_USE 以下のメリット値を持つカテゴリをすべて除外することによって、グラフの作成処理をアクセラレーションする。再生の際に考慮すべきでないフィルタ カテゴリには、MERIT_DO_NOT_USE 以下のメリット値を設定すること。
検索範囲を絞るため、1 つのフィルタは 1 つ以上のカテゴリに含めることができる (たとえばビデオ コンプレッサ)。
参照