AoFindFormats()

Updated: May 06, 2022

Find the control best suited for a specific media format

Synopsis:

#include <aoi.h>

const AOICtrl_t *AoFindFormats(const AODataFormat_t *fmt,
                               int32_t *rating,
                               const char *oiface,
                               int32_t version);

Arguments:

fmt
A pointer to an AODataFormat_t structure that defines the media format 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 media format.
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 AOFormatInspector interface that returns the best rating for the given media format, 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