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

Интерфейс IFilterChain (strmif.h)

  • Статья

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

Интерфейс IFilterChain предоставляет методы для запуска, остановки или удаления цепочек фильтров в графе фильтров. Диспетчер графов фильтров предоставляет этот интерфейс.

Цепочка фильтров — это последовательность фильтров, каждая из которых содержит не более одного подключенного входного контакта и одного подключенного выходного контакта, образующего непрерывную линию фильтров. Цепочка фильтров определяется фильтром в начале цепочки и фильтром в конце цепочки. (Это может быть один и тот же фильтр, что делает цепочку из одного фильтра.) По определению существует один путь потока, идущий от начала цепочки вниз до конца цепочки.

Методы в этом интерфейсе полезны в ситуациях, когда может появиться или исчезнуть весь поток данных, например приложение для видеоконференций, которое получает несколько потоков по сети. Дополнительные сведения см. в разделе Dynamic Graph Building. Для управления отдельными потоками в фильтре захвата используйте интерфейс IAMStreamControl .

Наследование

Интерфейс IFilterChain наследуется от интерфейса IUnknown . IFilterChain также имеет следующие типы элементов:

Методы

Интерфейс IFilterChain содержит следующие методы.

 
IFilterChain::P auseChain

Метод PauseChain переключает все фильтры в цепочке фильтров в приостановленное состояние.
IFilterChain::RemoveChain

Метод RemoveChain удаляет каждый фильтр в цепочке фильтров из графа фильтров.
IFilterChain::StartChain

Метод StartChain переключает все фильтры в цепочке фильтров в состояние выполнения.
IFilterChain::StopChain

Метод StopChain переключает все фильтры в цепочке фильтров в остановленное состояние.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)