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

AOStreamInspector

Rate a stream

Synopsis:

static AOStreamInspector media_filter =
{
    RateStream
};

Description:

Use this interface to determine if a given stream can be processed with this inspector's addon.

RateStream()

int32_t (*RateStream)(AOIStream_t *stream);

This function should return a rating, from 0 to 100, of how sure the filter is that it can process the given stream, where 100 is the best rating.

As a guideline, multimedia rating functions in existing filters return 80 when they can process data.

You should use only the AOStreamer's Sniff() function in this function. You should never call Read() from this function. You can use RateStream() to create a handle for the filter with the highest rating.

Classification:

Neutrino

See also:

AoExtInspector, AoFormatInspector, AoMimetypeInspector

Extending the Multimedia Framework.