| Microsoft DirectX 8.1 (C++) |
The AddSourceFilter method adds a source filter to the filter graph, for a specified file. This method is intended for use by Visual Basic applications. C++ applications should use the IGraphBuilder::AddSourceFilter method.
Syntax
HRESULT AddSourceFilter(
BSTR strFilename,
IDispatch **ppUnk
);
Parameters
strFilename
[in] Name of the file containing the source video.
ppUnk
[out] Address of a pointer that will receive the IFilterInfo interface on the filter.
Return Values
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| S_OK | Success. |
| E_OUTOFMEMORY | Insufficient memory. |
| VFW_E_CANNOT_LOAD_SOURCE_FILTER | The source filter for this file could not be loaded. |
| VFW_E_NOT_FOUND | An object or name was not found. |
| VFW_E_UNKNOWN_FILE_TYPE | The media type of this file is not recognized. |
Remarks
This method is primarily for use by Automation clients because it returns an IDispatch interface pointer.
See Also