AoFindStreams()

Find the control best suited for a specific stream

Synopsis:

#include <aoi.h>

const AOICtrl_t *AoFindStreams(AOIStream_t *stream,
                               int32_t *rating,
                               const char *oiface,
                               int32_t version);

Arguments:

stream: A pointer to an AOIStream_t structure representing the stream for which you want to find the highest rated control.
rating: A pointer to memory for storing the rating, from 0 to 100, of how well the returned control can handle the given stream.
oiface: The name of the interface that the returned control must contain. This argument can be NULL if you don't need an extra interface.
version: The minimum version of the interface specified with the oiface argument; this is ignored if oiface is NULL.

Library:

libaoi.so

Description:

This function finds the control that has an AOStreamInspector interface that returns the best rating for the given stream, and that has the given interface name and minimum version (if specified).

Returns:

A pointer to an AOICtrl_t structure for the control that meets the search criteria, or NULL if no such control is found.

Classification:

QNX Neutrino