Метод IMediaFilter::Run (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Метод Run запускает фильтр.
Синтаксис
HRESULT Run(
REFERENCE_TIME tStart
);
Параметры
tStart
Время ссылки, соответствующее времени потока 0.
Возвращаемое значение
Возвращает значение HRESULT . Возможные значения включают значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Переход не завершен. |
|
Успешно. Переход завершен. |
Комментарии
При выполнении фильтра он может получать, обрабатывать и доставлять примеры. Исходные фильтры создают новые примеры, а фильтры отрисовщика отрисовывают их.
Переход состояния может быть асинхронным. Если метод возвращается до завершения перехода, возвращаемое значение S_FALSE.
Stream время вычисляется как текущее время ссылки минус tStart. Чтобы вычислить время отрисовки примера носителя, отрисовщик сравнивает метку времени с текущим временем потока. Таким образом, образец носителя с нулевой меткой времени должен быть отрисован во время tStart. Дополнительные сведения см. в разделе Время и часы в DirectShow.
Когда приложение вызывает метод IMediaControl::Run , диспетчер фильтров Graph вызывает IMediaFilter::Run для каждого фильтра. Он задает значение tStart слегка в будущем, чтобы учесть задержку графа.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |