Интерфейс IMediaControl (control.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Интерфейс IMediaControl предоставляет методы для управления потоком данных через граф фильтра. Он включает методы для выполнения, приостановки и остановки графа. Диспетчер фильтров графов реализует этот интерфейс. Дополнительные сведения о состояниях графа фильтров см. в разделе Поток данных в графе фильтров.
Наследование
Интерфейс IMediaControl наследуется от интерфейса IDispatch . IMediaControl также имеет следующие типы членов:
Методы
Интерфейс IMediaControl содержит следующие методы.
| IMediaControl::AddSourceFilter Метод AddSourceFilter добавляет фильтр источника в граф фильтра. |
| IMediaControl::get_FilterCollection Метод get_FilterCollection извлекает коллекцию фильтров в графе фильтров. |
| IMediaControl::get_RegFilterCollection Метод get_RegFilterCollection извлекает коллекцию всех фильтров, перечисленных в реестре. |
| IMediaControl::GetState Метод GetState извлекает состояние графа фильтра приостановлено, запущено или остановлено. |
| IMediaControl::P ause Метод Pause приостанавливает все фильтры в графе фильтров. |
| IMediaControl::RenderFile Метод RenderFile создает граф фильтра, который отрисовывает указанный файл. (IMediaControl.RenderFile) |
| IMediaControl::Run Метод Run запускает все фильтры в графе фильтров. Во время работы графа данные перемещаются по графу и отрисовывается. |
| IMediaControl::Stop Метод Stop останавливает все фильтры в графе. |
| IMediaControl::StopWhenReady Метод StopWhenReady приостанавливает граф фильтров, позволяя фильтрам помещать данные в очередь, а затем останавливает граф фильтров. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | control.h (включая Dshow.h) |