MFCreateVideoRendererActivate 函数 (mfidl.h)

为增强的视频呈现器 (EVR) 媒体接收器创建激活对象。

语法

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

[in] hwndVideo

显示视频的窗口的句柄。

[out] ppActivate

接收指向 IMFActivate 接口的指针。使用此接口创建 EVR。调用方必须释放接口。

函数返回 HRESULT。可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。

若要创建 EVR，请在检索到的 IMFActivate 指针上调用 IMFActivate ：：ActivateObject。 (如果使用媒体会话，媒体会话会在将 topology 排队时自动调用 ActivateObject 。)

若要配置 EVR，请在调用 ActivateObject 之前，在 IMFActivate 对象上设置以下任何属性。

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 时，激活对象通过调用 IMFVideoDisplayControl：：SetVideoPosition 设置 EVR 上的视频窗口。为 hwndVideo 参数传递 NULL 不是错误，但除非 EVR 具有有效的视频窗口，否则不会呈现任何视频。