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

指向以下项之一的指针：

• 媒体基础转换 (公开 IMFTransform 接口的 MFT) 。
• 公开 IMFActivate 接口的 MFT 激活对象。

返回值

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

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

注解

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

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

要求

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

另请参阅

IMFCaptureSource