Интерфейс 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)