iFileSinkFilter 接口 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
接口 IFileSinkFilter 在将媒体流写入文件的筛选器上实现。 例如，视频捕获筛选器图中的文件接收器筛选器将视频压缩筛选器的输出写入文件。 通常，运行此筛选器图的应用程序应允许用户输入要写入的文件的名称。 此接口支持此信息的通信。
如果筛选器需要输出文件的名称，它应公开此接口以允许应用程序设置文件名。 请注意，当前没有此接口的基类实现。
必须设置文件接收器筛选器将写入的文件的名称的任何应用程序都应使用此接口来获取和设置文件名。
继承
IFileSinkFilter 接口继承自 IUnknown 接口。 IFileSinkFilter 还具有以下类型的成员：
方法
IFileSinkFilter 接口包含以下方法。
| IFileSinkFilter：：GetCurFile GetCurFile 方法检索当前文件的名称和媒体类型。 (IFileSinkFilter.GetCurFile) |
| IFileSinkFilter：：SetFileName SetFileName 方法设置将向其写入媒体示例的文件的名称。 |
注解
IFileSinkFilter2 接口扩展了 IFileSinkFilter。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |