IFileSinkFilter interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The IFileSinkFilter interface is implemented on filters that write media streams to a file. A file sink filter in a video capture filter graph, for instance, writes the output of the video compression filter to a file. Typically, the application running this filter graph should enable the user to enter the name of the file to be written to. This interface enables the communication of this information.
If a filter needs the name of an output file, it should expose this interface to allow an application to set the file name. Note that there is currently no base class implementation of this interface.
Any application that must set the name of the file into which the file sink filter will write should use this interface to get and set the file name.
Inheritance
The IFileSinkFilter interface inherits from the IUnknown interface. IFileSinkFilter also has these types of members:
Methods
The IFileSinkFilter interface has these methods.
| IFileSinkFilter::GetCurFile The GetCurFile method retrieves the name and media type of the current file. (IFileSinkFilter.GetCurFile) |
| IFileSinkFilter::SetFileName The SetFileName method sets the name of the file into which media samples will be written. |
Remarks
The IFileSinkFilter2 interface extends IFileSinkFilter.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |