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


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

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

Интерфейс IMediaFilter управляет состоянием потоковой передачи фильтра.

Все фильтры DirectShow реализуют этот интерфейс. Он предоставляет методы для переключения фильтра между состояниями (остановлено, приостановлено и запущено); для получения текущего состояния фильтра; и для задания эталонных часов. Приложения не должны вызывать IMediaFilter методы для фильтров.

Диспетчер графов фильтров также предоставляет этот интерфейс. Приложения могут использовать метод SetSyncSource для задания ссылочных часов графа и GetSyncSource для получения часов. Приложения не должны вызывать другие методы в этом интерфейсе. Вместо этого используйте соответствующие методы в интерфейсе IMediaControl .

Интерфейс IBaseFilter наследуется от IMediaFilter.

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

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

Методы

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

 
IMediaFilter::GetState

Метод GetState извлекает состояние фильтра (запущено, остановлено или приостановлено).
IMediaFilter::GetSyncSource

Метод GetSyncSource извлекает текущие эталонные часы.
IMediaFilter::P ause

Метод Pause приостанавливает фильтр.
IMediaFilter::Run

Метод Run запускает фильтр.
IMediaFilter::SetSyncSource

Метод SetSyncSource задает ссылочные часы.
IMediaFilter::Stop

Метод Stop останавливает фильтр.

Требования

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