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

Метод ICaptureGraphBuilder::FindInterface (strmif.h)

  • Статья

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

Примечание Интерфейс ICaptureGraphBuilder является устаревшим. Вместо этого используйте ICaptureGraphBuilder2 .
 
Выполняет поиск указанного интерфейса в фильтре, вышестоящий и ниже от фильтра, а также, при необходимости, только в выходном контакте данной категории.

Синтаксис

HRESULT FindInterface(
  [in]  const GUID  *pCategory,
  [in]  IBaseFilter *pf,
  [in]  REFIID      riid,
  [out] void        **ppint
);

Параметры

[in] pCategory

Указатель на GUID, указывающий категорию выходного закрепления. Список всех категорий закрепления см. в разделе Набор свойств закрепления. Значение NULL означает поиск по всем выходным контактам независимо от категории.

[in] pf

Указатель на интерфейс IBaseFilter фильтра.

[in] riid

Идентификатор ссылки нужного интерфейса.

[out] ppint

Адрес указателя void. Если интерфейс найден, этот метод инициализирует ppint , чтобы он содержал адрес указателя на найденный интерфейс. Вызовите метод Release для уменьшения количества ссылок после завершения работы с интерфейсом .

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

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

Комментарии

Этот метод выполняет поиск интерфейса фильтра и вышестоящий и нижестоящего фильтра, если не указана категория. Если указана категория, она выполняет поиск только вниз от выходного маркера этой категории. Его можно использовать для поиска интерфейсов на отрисовщиках, мультиплексорах, ТВ-тюнерах, перекладинки и т. д.

Если pCategory равно &LOOK_UPSTREAM_ONLY, то построитель графов будет искать вышестоящий фильтра, заданного в параметре pf, но не сам фильтр или подчиненный фильтр.

Если pCategory равно &LOOK_DOWNSTREAM_ONLY, построитель графов будет искать вниз от фильтра, заданного в параметре pf, но не на самом фильтре и не вышестоящий фильтра.

Требования

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

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

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

Интерфейс ICaptureGraphBuilder