向捕获流添加效果。
Syntax
HRESULT AddEffect(
[in] DWORD dwSourceStreamIndex,
[in] IUnknown *pUnknown
);
参数
[in] dwSourceStreamIndex
捕获流。 该值可以是以下任一值。
| 价值 | Meaning |
|---|---|
|
流的从零开始的索引。 若要获取流数，请调用 IMFCaptureSource：：GetDeviceStreamCount。 |
|
第一个图像流。 |
|
第一个视频流。 |
|
第一个音频流。 |
[in] pUnknown
指向以下项之一的指针：
- 公开 IMFTransform 接口的媒体基础转换 （MFT）。
- 公开 IMFActivate 接口的 MFT 激活对象。
返回值
此方法可以返回其中一个值。
| 返回代码 | Description |
|---|---|
|
成功。 |
|
找不到兼容的媒体类型。 |
|
dwSourceStreamIndex 参数无效。 |
注解
效果必须作为 媒体基础转换 （MFT）实现。 pUnknown 参数可以指向 MFT 的实例或 MFT 的激活对象。 有关详细信息，请参阅 激活对象。
在数据到达捕获接收器之前，该效果将应用于流。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 8 [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2012 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | mfcaptureengine.h |