IFilterChain interface (strmif.h)

The IFilterChain interface provides methods for starting, stopping, or removing chains of filters in a filter graph. The filter graph manager exposes this interface.

A filter chain is a sequence of filters, each with at most one connected input pin and one connected output pin, that forms an unbroken line of filters. A filter chain is defined by the filter at the start of the chain and the filter at the end of the chain. (These can be the same filter, making a chain of one filter.) By definition, there is a single stream path going from the start of the chain downstream to the end of the chain.

The methods on this interface are useful in situations where an entire stream of data can appear or disappear, such as a video conferencing application that receives multiple streams over a network. For more information, see Dynamic Graph Building. To control individual streams on a capture filter, use the IAMStreamControl interface instead.

Inheritance

The IFilterChain interface inherits from the IUnknown interface. IFilterChain also has these types of members:

Methods

The IFilterChain interface has these methods.

 
IFilterChain::PauseChain

The PauseChain method switches all the filters in a filter chain into a paused state.
IFilterChain::RemoveChain

The RemoveChain method removes every filter in a filter chain from the filter graph.
IFilterChain::StartChain

The StartChain method switches all the filters in a filter chain into a running state.
IFilterChain::StopChain

The StopChain method switches all the filters in a filter chain into a stopped state.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)