iMediaFilter 接口 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

接口 IMediaFilter 控制筛选器的流状态。

所有 DirectShow 筛选器都实现此接口。 它提供了在停止、暂停和正在运行 (状态之间切换筛选器的方法，) ;用于检索筛选器的当前状态;和 ，用于设置参考时钟。 应用程序不应对筛选器调用 IMediaFilter 方法。

Filter Graph 管理器还公开此接口。 应用程序可以使用 SetSyncSource 方法设置图形引用时钟，使用 GetSyncSource 检索时钟。 应用程序不应在此接口上调用其他方法。 请改用 IMediaControl 接口上的相应方法。

IBaseFilter 接口继承自 IMediaFilter。

继承

IMediaFilter 接口继承自 IPersist。 IMediaFilter 还具有以下类型的成员：

方法

IMediaFilter 接口具有这些方法。

IMediaFilter：：GetState GetState 方法检索筛选器的状态 (运行、停止或暂停) 。
IMediaFilter：：GetSyncSource GetSyncSource 方法检索当前引用时钟。
IMediaFilter：:P ause Pause 方法暂停筛选器。
IMediaFilter：：Run Run 方法运行筛选器。
IMediaFilter：：SetSyncSource SetSyncSource 方法设置引用时钟。
IMediaFilter：：Stop Stop 方法停止筛选器。

要求

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