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.

Members

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

Methods

The IFilterChain interface has these methods.

MethodDescription
PauseChain

Switches all the filters in a filter chain into a paused state.

RemoveChain

Removes every filter in a filter chain from the filter graph.

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.

 

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

 

 

Community Additions

ADD
Show:
© 2015 Microsoft