FilterGraphTools.AddFilterByName Method

DirectShowLib.Utils

A Managed DirectShow Toolkit

FilterGraphTools.AddFilterByName Method 

Add a filter to a DirectShow Graph using its name

public static IBaseFilter AddFilterByName(
   IGraphBuilder graphBuilder,
   Guid deviceCategory,
   string friendlyName
);

Parameters

graphBuilder
the IGraphBuilder interface of the graph
deviceCategory
the filter category (see DirectShowLib.FilterCategory)
friendlyName
the filter name (case-sensitive)

Return Value

an instance of the filter if the method successfully created it, null if not

Exceptions

Exception Type Condition
ArgumentNullException Thrown if graphBuilder is null
COMException Thrown if errors occur when the filter is add to the graph

Example

This sample shows how to programmatically add a NVIDIA Video decoder filter to a graph

filter = FilterGraphTools.AddFilterByName(graphBuilder, FilterCategory.LegacyAmFilterCategory, "NVIDIA Video Decoder");

See Also

FilterGraphTools Class | DirectShowLib.Utils Namespace