Share via

IEnumFilters Interface

  • Article
 
Microsoft DirectShow 9.0

IEnumFilters Interface

The IEnumFilters interface enumerates the filters in a filter graph. To obtain this interface, call the IFilterGraph::EnumFilters method on the Filter Graph Manager. For more information, see Enumerating Objects in a Filter Graph.

This interface implements a standard Component Object Model (COM) collection object. For more information on COM collections, see the IEnumXXXX topic in the Platform SDK.

If the set of filters in the graph changes, some methods on this interface return VFW_E_ENUM_OUT_OF_SYNC. Call the IEnumFilters::Reset method to resynchronize the enumerator.

In addition to the methods inherited from IUnknown, the IEnumFilters interface exposes the following methods.

Method Description
Clone Makes a copy of the enumerator object.
Next Retrieves the specified number of filters in the enumeration sequence.
Reset Resets the enumeration sequence to the beginning.
Skip Skips over a specified number of filters.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.