IMFCaptureSource::AddEffect 方法 (mfcaptureengine.h)

向捕获流添加效果。

语法

HRESULT AddEffect(
  [in] DWORD    dwSourceStreamIndex,
  [in] IUnknown *pUnknown
);

参数

[in] dwSourceStreamIndex

捕获流。 该值可以是以下任一值。

含义
0–0xFFFFFFFB
流的从零开始的索引。 若要获取流数,请调用 IMFCaptureSource::GetDeviceStreamCount
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
第一个图像流。
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
第一个视频流。
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
第一个音频流。

[in] pUnknown

指向以下项之一的指针:

返回值

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

返回代码 说明
S_OK
成功。
MF_E_INVALIDMEDIATYPE
找不到兼容的媒体类型。
MF_E_INVALIDSTREAMNUMBER
dwSourceStreamIndex 参数无效。

注解

效果必须作为 媒体基础转换 实现, (MFT) 。 pUnknown 参数可以指向 MFT 的实例,也可以指向 MFT 的激活对象。 有关详细信息,请参阅 激活对象

该效果在数据到达捕获接收器之前应用于流。

要求

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

另请参阅

IMFCaptureSource