IMFASFProfile::GetStream 方法 (wmcontainer.h)
按流索引从配置文件中检索流,和/或检索流索引的流编号。
语法
HRESULT GetStream(
[in] DWORD dwStreamIndex,
[out] WORD *pwStreamNumber,
[out] IMFASFStreamConfig **ppIStream
);
参数
[in] dwStreamIndex
要检索的流的索引。 Stream索引是有序的,从零开始。 可以通过调用 IMFASFProfile::GetStreamCount 方法获取配置文件中的流数。
[out] pwStreamNumber
接收所请求流的流号。 Stream数字从 1 开始,不一定是连续的。 如果不需要流号,则可以将此参数设置为 NULL 。
[out] ppIStream
接收指向 ASF 流配置对象的 IMFASFStreamConfig 接口的指针。 调用方必须释放接口。 如果要在不访问流配置的情况下检索流编号,此参数可以为 NULL 。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
注解
此方法不会创建流配置对象的副本。 检索到的指针指向配置文件对象中的 对象。 不得使用此指针对流配置对象进行任何更改,因为这样做可能会以意外的方式影响配置文件对象。
若要更改配置文件中流配置对象的配置,必须先通过调用 IMFASFStreamConfig::Clone 来克隆流配置对象。 对对象的克隆进行所需的任何更改,然后通过调用 IMFASFProfile::SetStream 方法添加更新的对象。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wmcontainer.h |
Library | Mfuuid.lib |