IMFMediaEngineEx::InsertAudioEffect 方法 (mfmediaengine.h)

插入音频效果。

语法

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

参数

[in] pEffect

下列类型作之一:

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

[in] fOptional

指定效果是否为可选效果。

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

返回值

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

返回代码 说明
S_OK
成功。
MF_E_INVALIDREQUEST
已达到音频效果的最大数目。

注解

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

要求

要求
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 mfmediaengine.h

另请参阅

IMFMediaEngineEx