IMFMediaEngineEx::InsertVideoEffect 方法 (mfmediaengine.h)

插入视频效果。

Syntax

HRESULT InsertVideoEffect(
  [in] IUnknown *pEffect,
  [in] BOOL     fOptional
);

参数

[in] pEffect

以下之一:

  • 指向实现视频效果的媒体基础转换 (MFT) 的 IMFTransform 接口的指针。
  • 指向激活对象的 IMFActivate 接口的指针。 激活对象必须为视频效果创建 MFT。

[in] fOptional

指定效果是否可选。

价值 Meaning
TRUE
效果是可选的。 如果媒体引擎无法添加效果,它将忽略该效果并继续播放。
FALSE
需要效果。 如果媒体引擎对象无法添加效果,则会发生播放错误。

返回值

此方法可以返回其中一个值。

返回代码 Description
S_OK
成功。
MF_E_INVALIDREQUEST
达到最大视频效果数。

注解

加载下一个媒体资源时,将应用该效果。

要求

Requirement 价值
最低支持的客户端 Windows 8 [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows操作系统
Header mfmediaengine.h

另请参阅

IMFMediaEngineEx