IVMRFilterConfig::SetImageCompositor 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 SetImageCompositor 安装应用程序提供的映像合成器。

语法

HRESULT SetImageCompositor(
  [in] IVMRImageCompositor *lpVMRImgCompositor
);

参数

[in] lpVMRImgCompositor

指向图像合成器的 IVMRImageCompositor 接口的指针。

返回值

如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。

返回代码 说明
VFW_E_WRONG_STATE
混音器当前未加载。

注解

使用此方法将 VMR 的默认合成器替换为应用程序提供的自定义合成器。 图像合成器是混音器的子组件。

当 VMR 处于无窗口模式或窗口模式时,将自动加载合成器。 当 VMR 处于无呈现模式时,必须通过调用 IVMRFilterConfig::SetNumberOfStreams 来加载合成器。 VMR 管理 IVMRImageCompositor 接口上的所有引用计数。

要求

要求
最低受支持的客户端 具有 SP1 的 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IVMRFilterConfig 接口

使用视频混合呈现器