This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

MmFindChannelsFilter()

Find the best filter for an output channel

Synopsis:

MmFilter_t *MmFindChannelsFilter(MmGraph_t *graph,
                                 MmChannel_t *channel);

Arguments:

graph

The graph you want to add the found filter to.

channel

A pointer to the channel you want to find the best filter for.

Library:

mmedia

Description:

This function creates a context for the best filter it can find in the list of interfaces for the output channel in the graph, acquires an input channel from it, and attaches the two channels. It returns the newly created filter.

If the output channel is a streamer, the function calls MmFindStreamsAddon() to find the best filter for the stream type, and attaches it to. If the output channel uses buffers, the function finds the addon that gives the best rating for each channel using MmFindFormatsAddon().

Returns:

A pointer to a new filter (an MmFilter_t) if successful, NULL if not, or if no addon with a rating greater than 0 can be found.

Classification:

Neutrino

See also:

MmDestroyFilter(), MmFilter_t, MmFindFilter(), MmFindMediaReader(), MmFindMimetypesFilter()