将捕获源中的流连接到此捕获接收器。
Syntax
HRESULT AddStream(
[in] DWORD dwSourceStreamIndex,
[in] IMFMediaType *pMediaType,
[in] IMFAttributes *pAttributes,
[out] DWORD *pdwSinkStreamIndex
);
参数
[in] dwSourceStreamIndex
要连接的源流。 该值可以是以下任一值。
| 价值 | Meaning |
|---|---|
|
流的从零开始的索引。 若要获取流数,请调用 IMFCaptureSource::GetDeviceStreamCount。 |
|
第一个图像流。 |
|
第一个视频流。 |
|
第一个音频流。 |
[in] pMediaType
指定输出流的所需格式的 IMFMediaType 指针。 格式的详细信息将取决于捕获接收器。
- 照片接收器:与 Windows 映像组件 (WIC)兼容的静止图像格式。
- 预览接收器:未压缩的音频或视频格式。
- 录制接收器:将写入输出文件的音频或视频格式。
[in] pAttributes
指向 IMFAttributes 接口的指针。 对于压缩流,可以使用此参数配置编码器。 此参数也可以为 NULL。
对于预览接收器,请将此参数设置为 NULL。
[out] pdwSinkStreamIndex
接收捕获接收器上新流的索引。 请注意,此索引不一定与 dwSourceStreamIndex 的值匹配。
返回值
此方法可以返回其中一个值。
| 返回代码 | Description |
|---|---|
|
成功。 |
|
pMediaType 中指定的格式对此捕获接收器无效。 |
|
dwSourceStreamIndex 参数无效,或者指定的源流已连接到此接收器。 |
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 8 [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2012 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | mfcaptureengine.h |