Метод IVMRImagePresenter::StartPresenting (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Метод StartPresenting вызывается непосредственно перед началом воспроизведения видео. Allocator-presenter должен выполнить любую необходимую настройку в этом методе.
Синтаксис
HRESULT StartPresenting(
[in] DWORD_PTR dwUserID
);
Параметры
[in] dwUserID
Определенный приложением DWORD_PTR файл cookie, который однозначно идентифицирует этот экземпляр VMR для использования в сценариях, когда один экземпляр allocator-presenter используется с несколькими экземплярами VMR.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Метод PresentImage может вызываться, когда фильтр находится в запущенном или приостановленном состоянии. StartPresenting и StopPresenting можно вызывать только в состоянии выполнения. Таким образом, если граф приостановлен перед запуском, Метод PresentImage будет вызываться перед StartPresenting.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP с пакетом обновления 1 (SP1) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |