Метод IMediaControl::Stop (control.h)

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

Метод Stop останавливает все фильтры в графе.

Синтаксис

HRESULT Stop();

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

Возвращает S_OK в случае успешного выполнения или значение HRESULT , указывающее причину ошибки.

Комментарии

Если граф выполняется, этот метод приостанавливает граф перед его остановкой. Пока отрисовщики видео приостановлены, могут скопировать текущий кадр для отображения в виде кадра плаката.

Этот метод не стремится к началу потока. Если вызвать этот метод, а затем вызвать метод IMediaControl::Run , воспроизведение возобновляется из остановленной позиции. Для поиска используйте интерфейс IMediaSeeking .

Диспетчер графа фильтров приостанавливает все фильтры в графе, а затем вызывает метод IMediaFilter::Stop для всех фильтров, не дожидаясь завершения операций приостановки. Таким образом, некоторые фильтры могут вызывать метод Stop до завершения операции приостановки. Если вы разрабатываете пользовательский фильтр отрисовки, возможно, потребуется обработать этот случай, приостановив фильтр, если он получает команду stop в состоянии выполнения. Однако большинству фильтров не нужно предпринимать никаких специальных действий в этом отношении.

Требования

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

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

Коды ошибок и успешного выполнения

Интерфейс IMediaControl

StopWhenReady