Share via

Метод IFilterMapper2::CreateCategory (strmif.h)

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод CreateCategory добавляет новую категорию фильтра в реестр.

Синтаксис

HRESULT CreateCategory(
  [in] REFCLSID clsidCategory,
  [in] DWORD    dwCategoryMerit,
  [in] LPCWSTR  Description
);

Параметры

[in] clsidCategory

Идентификатор класса (CLSID) новой категории фильтра.

[in] dwCategoryMerit

Заслуга категории. Сначала перечисляются категории с более высокими достоинствами.

[in] Description

Описательное имя категории.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения или значение HRESULT , указывающее причину ошибки.

Комментарии

Диспетчер графов фильтров изначально пропускает все категории со значением заслуги, которое меньше или равно MERIT_DO_NOT_USE, чтобы ускорить процесс создания графа. Категории фильтров, которые не следует рассматривать для воспроизведения, должны иметь MERIT_DO_NOT_USE или меньше.

Фильтр может отображаться в одной или нескольких категориях (например, Видеокомпрессоры), чтобы ограничить пространство поиска.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

См. также раздел

Коды ошибок и успешности

Интерфейс IFilterMapper2