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。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。

注解

此方法不会创建流配置对象的副本。 检索到的指针指向配置文件对象中的 对象。 不得使用此指针对流配置对象进行任何更改,因为这样做可能会以意外的方式影响配置文件对象。

若要更改配置文件中流配置对象的配置,必须先通过调用 IMFASFStreamConfig::Clone 来克隆流配置对象。 对对象的克隆进行所需的任何更改,然后通过调用 IMFASFProfile::SetStream 方法添加更新的对象。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wmcontainer.h
Library Mfuuid.lib

另请参阅

ASF 配置文件

IMFASFProfile

IMFASFProfile::GetStreamByNumber

IMFASFProfile::GetStreamCount

IMFASFProfile::RemoveStream

IMFASFProfile::SetStream

IMFASFStreamConfig