Поделиться через

Функция MFCreateVideoRendererActivate (mfidl.h)

  • Статья

Создает объект активации для приемника мультимедиа расширенного видео отрисовщика (EVR).

Синтаксис

HRESULT MFCreateVideoRendererActivate(
  [in]  HWND        hwndVideo,
  [out] IMFActivate **ppActivate
);

Параметры

[in] hwndVideo

Дескриптор к окну, в котором будет отображаться видео.

[out] ppActivate

Получает указатель на интерфейс IMFActivate . Используйте этот интерфейс для создания EVR. Вызывающий объект должен освободить интерфейс .

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.

Комментарии

Чтобы создать EVR, вызовите IMFActivate::ActivateObject в полученном указателе IMFActivate . (Если вы используете сеанс мультимедиа, сеанс мультимедиа автоматически вызывает ActivateObject при постановке топологии в очередь.)

Чтобы настроить EVR, задайте любой из следующих атрибутов объекта IMFActivate перед вызовом ActivateObject.

attribute Описание
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE Объект активации для пользовательского микшера.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID CLSID для пользовательского микшера.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS Флаги для создания пользовательского микшера.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE Объект активации для пользовательского докладчика.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID CLSID для настраиваемого докладчика.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS Флаги для создания пользовательского докладчика.
 

При вызове IMFActivate::ActivateObject объекты активации задают окно видео в EVR путем вызова IMFVideoDisplayControl::SetVideoPosition. Передача значения NULL для параметра hwndVideo не является ошибкой, но видео не будет отображаться, если в EVR нет допустимого окна видео.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header mfidl.h
Библиотека Mf.lib
DLL Mf.dll

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

Объекты активации

Расширенный отрисовщик видео

Функции Media Foundation