Метод IMediaFilter::P ause (strmif.h)

  • Статья

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

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

Синтаксис

HRESULT Pause();

Возвращаемое значение

Возвращает значение HRESULT . Возможные значения включают значения, приведенные в следующей таблице.

Код возврата Описание
S_FALSE
 Переход не завершен.
S_OK
 Успешно. Переход завершен.

Комментарии

Когда фильтр приостановлен, он может получать, обрабатывать и доставлять примеры. Однако фильтр отрисовщика будет принимать только один образец во время приостановки. Поэтому при приостановке графа фильтра примеры перемещаются по графу до тех пор, пока первая выборка не достигнет отрисовщика. На этом этапе потоковая передача приостанавливается до вызова метода IMediaFilter::Run . Отрисовщики видео отображают первый образец в виде неподвижного кадра.

Фильтры динамического захвата не доставляют образцы во время приостановки, а только во время выполнения.

Переход состояния может быть асинхронным. Если метод возвращается до завершения перехода, возвращаемое значение будет S_FALSE. Фильтр отрисовщика не завершает переход на приостановленный, пока (1) он не получит один пример или (2) не получит уведомление об окончании потока. Пока переход состояния находится в ожидании, IMediaFilter::GetState возвращает VFW_S_STATE_INTERMEDIATE.

Требования

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

См. также раздел

Коды ошибок и успешности

IBaseFilter

Интерфейс IMediaFilter