iFilterChain 接口 (strmif.h)

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayerIMFMediaEngine媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

接口 IFilterChain 提供用于在筛选器图中启动、停止或删除筛选器链的方法。 筛选器图管理器公开此接口。

筛选器链是一系列筛选器,每个筛选器最多有一个连接的输入引脚和一个连接的输出引脚,构成一个不间断的筛选器行。 筛选器链由链开头的筛选器和链末尾的筛选器定义。 (这些可以是同一个筛选器,生成一个 filter 的链。) 根据定义,有一个流路径从链的开头下游到链的末尾。

此接口上的方法适用于整个数据流可能显示或消失的情况,例如通过网络接收多个流的视频会议应用程序。 有关详细信息,请参阅 动态图形生成。 若要控制捕获筛选器上的单个流,请改用 IAMStreamControl 接口。

继承

IFilterChain 接口继承自 IUnknown 接口。 IFilterChain 还具有以下类型的成员:

方法

IFilterChain 接口包含以下方法。

 
IFilterChain::P auseChain

PauseChain 方法将筛选器链中的所有筛选器切换为暂停状态。
IFilterChain::RemoveChain

RemoveChain 方法从筛选器图中删除筛选器链中的每个筛选器。
IFilterChain::StartChain

StartChain 方法将筛选器链中的所有筛选器切换为运行状态。
IFilterChain::StopChain

StopChain 方法将筛选器链中的所有筛选器切换为停止状态。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)