Метод IVMRImagePresenter::P resentImage (strmif.h)

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

Метод PresentImage вызывается именно в тот момент, когда должен быть представлен этот видеокадр.

Синтаксис

HRESULT PresentImage(
  [in] DWORD_PTR           dwUserID,
  [in] VMRPRESENTATIONINFO *lpPresInfo
);

Параметры

[in] dwUserID

Определяемый приложением DWORD_PTR, который однозначно идентифицирует этот экземпляр VMR в сценариях, когда несколько экземпляров VMR используются с одним экземпляром Allocator-Presenter. См. примечания

[in] lpPresInfo

Задает структуру VMRPRESENTATIONINFO .

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

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

PresentImage может вызываться, если фильтр находится в запущенном или приостановленном состоянии. StartPresenting и StopPresenting можно вызывать только в состоянии выполнения. Таким образом, если граф приостановлен перед выполнением, PresentImage будет вызываться до запускаPresenting.

Приложения могут создавать настраиваемые эффекты смешивания, используя один экземпляр Allocator-Presenter с несколькими экземплярами VMR либо в одном графе фильтра, либо в нескольких графах фильтров. Использование докладчика распределителя таким образом позволяет приложениям смешивать потоки из разных графов фильтров или смешивать разные потоки в одном и том же графе фильтра. Если вы используете один экземпляр VMR, задайте для этого значения нулевое значение.

Требования

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

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

Интерфейс IVMRImagePresenter

Использование отрисовщика смешанного видео