IFileSourceFilter 接口 (strmif.h)

  • 项目

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

接口 IFileSourceFilter 由源筛选器公开，用于设置要呈现的媒体文件的文件名和媒体类型。 它是 COM IPersistFile 接口的缩写版本。 如果文件的类型可由 注册自定义文件类型中所述的算法确定，则当筛选器图管理器尝试呈现筛选器图时，将使用建议的文件源筛选器 CLSID。

如果筛选器需要打开文件的名称，则应公开此接口以允许应用程序设置文件名。 请注意，此接口没有基类实现。

直接插入文件源筛选器的应用程序必须查询此接口并设置文件名。 通常，当应用程序调用 IGraphBuilder：：RenderFile 时，筛选器图管理器将使用此接口。 Graphedt.exe工具查询 IFileSourceFilter 接口，并在找到文件名时提示输入文件名。

继承

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

方法

IFileSourceFilter 接口包含以下方法。

 
IFileSourceFilter：：GetCurFile

GetCurFile 方法检索当前文件的名称和媒体类型。 (IFileSourceFilter.GetCurFile)
IFileSourceFilter：：Load

Load 方法会导致源筛选器加载媒体文件。

要求

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