IFilterChain Interface

Microsoft DirectShow 9.0

IFilterChain Interface

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.

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

Method	Description
StartChain	Switches all the filters in a filter chain into a running state.
StopChain	Switches all the filters in a filter chain into a stopped state.
RemoveChain	Removes every filter in a filter chain from the filter graph.
PauseChain	Switches all the filters in a filter chain into a paused state.

Requirements

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

Library: Use Strmiids.lib.