IFileSinkFilter2 接口 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
IFileSinkFilter2 接口扩展了 IFileSinkFilter 接口。 将媒体流写入文件的筛选器实现此接口。 例如,视频捕获筛选器图中的文件接收器筛选器会将视频压缩筛选器的输出保存到文件中。 通常,运行此筛选器图的应用程序应允许用户输入将数据保存到的文件的名称。 此接口使你能够传达此信息。
IFileSinkFilter2 添加了 选项,用于确定它写入的文件是否应销毁同名的现有文件。 在视频捕获情况下,请勿销毁已创建的文件,因为预分配文件空间需要花费大量时间。 默认情况下,新文件不会销毁旧文件。 否则,请销毁原始文件,以确保你创作的文件不包含垃圾。
继承
IFileSinkFilter2 接口继承自 IFileSinkFilter。 IFileSinkFilter2 还具有以下类型的成员:
方法
IFileSinkFilter2 接口包含以下方法。
IFileSinkFilter2::GetMode GetMode 方法检索文件编写器在创建新文件时是否销毁该文件。 |
IFileSinkFilter2::SetMode SetMode 方法确定文件编写器在创建新文件时是否销毁该文件。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | strmif.h (包括 Dshow.h) |