Метод IMediaControl::P ause (control.h)
[Функция, связанная с этой страницей, DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngineи аудио и видеозахват в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать новый код MediaPlayer, IMFMediaEngine и аудио-видеозахват в Media Foundation вместо DirectShowпо возможности. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]
Метод Pause приостанавливает все фильтры в графе фильтров.
Синтаксис
HRESULT Pause();
Возвращаемое значение
Возвращает значение HRESULT. Возможные значения включают следующие значения.
| Возвращаемый код | Описание |
|---|---|
|
Граф успешно приостановлен, но некоторые фильтры не завершили переход состояния. |
|
Все фильтры в графе завершили переход на приостановленное состояние. |
Замечания
Приостановка работы графа фильтра определяет граф для немедленной отрисовки при следующем запуске графа. Пока граф приостановлен, фильтрует данные, но не отрисовывает его. Данные передаются по графу и обрабатываются фильтрами преобразования до разрешения буферизации, но фильтры отрисовщика не отображают данные. Однако отрисовщики видео отображают статический кадр плаката первого примера.
Если метод возвращает S_FALSE, вызовите метод IMediaControl::GetState, чтобы дождаться завершения перехода состояния или проверить, завершен ли переход. При вызове Pause для отображения первого кадра видеофайла всегда следует немедленно с вызовом GetState, чтобы убедиться, что переход состояния завершен. Сбой этого может привести к тому, что прямоугольник видео окрашен черный.
Если метод завершается ошибкой, он останавливает граф перед возвратом.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | control.h (include Dshow.h) |
| библиотеки | Strmiids.lib |