Поделиться через

Метод IFilterMapper::EnumMatchingFilters (strmif.h)

  • Статья

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

Примечание Интерфейс IFilterMapper не рекомендуется использовать. Вместо этого используйте IFilterMapper2 .
 
Предоставляет перечислитель, который перечисляет зарегистрированные фильтры, соответствующие указанным требованиям.

Синтаксис

HRESULT EnumMatchingFilters(
  [out] IEnumRegFilters **ppEnum,
  [in]  DWORD           dwMerit,
        BOOL            bInputNeeded,
  [in]  CLSID           clsInMaj,
  [in]  CLSID           clsInSub,
  [in]  BOOL            bRender,
  [in]  BOOL            bOututNeeded,
  [in]  CLSID           clsOutMaj,
  [in]  CLSID           clsOutSub
);

Параметры

[out] ppEnum

Адрес указателя на возвращенный перечислитель.

[in] dwMerit

Минимальное значение заслуг фильтров для перечисления.

bInputNeeded

Значение, указывающее, должен ли быть хотя бы один входной контакт; Значение TRUE указывает, что требуется по крайней мере один входной контакт.

[in] clsInMaj

Требуется основной тип входных данных. Установите значение GUID_NULL, если вы не заботитесь.

[in] clsInSub

Требуется входной подтип. Установите значение GUID_NULL, если вы не заботитесь.

[in] bRender

Флаг, указывающий, должен ли фильтр отрисовывать входные данные; Истина означает, что она должна.

[in] bOututNeeded

Значение, указывающее, должен ли быть хотя бы один выходной контакт; ЗНАЧЕНИЕ TRUE указывает, что требуется по крайней мере один выходной контакт.

[in] clsOutMaj

Требуется основной тип выходных данных. Установите значение GUID_NULL, если вы не заботитесь.

[in] clsOutSub

Требуется выходной подтип. Установите значение GUID_NULL, если вы не заботитесь.

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

Возвращает значение HRESULT .

Комментарии

Задайте параметр ppEnum в качестве перечислителя для фильтров, соответствующих требованиям. Описание значений заслуг для параметра dwMerit см. в методе IFilterMapper::RegisterFilter .

Требования

Требование Значение
Целевая платформа Windows
Header strmif.h (включая Dshow.h)

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

Коды ошибок и успешного выполнения

Интерфейс IFilterMapper