IFileSourceFilter Interface
A version of this page is also available for
4/8/2010
This interface is exposed by source filters to set the file name and media type of the media file that they are to render. It is an abbreviated version of the COM IPersistFile interface.
If the file has a type that can be determined by the algorithm described in "Registering a Custom File Type," the recommended file source filter CLSID is used when the filter graph manager attempts to render the filter graph.
When to Implement
If a filter needs the name of a file to open, it should expose this interface to allow an application to set the file name.
There is no base class implementation of this interface.
When to Use
An application that inserts file source filters directly must query for this interface and set the file name. Normally, the filter graph manager uses this interface when an application calls IGraphBuilder::RenderFile.
Methods in Vtable Order
The following table shows the methods that appear in the Vtable beneath the standard COM methods inherited from IUnknown.
| Method | Description |
|---|---|
Loads the source filter with the file. |
|
Retrieves the current file. |
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment |