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

AoFindFormats()

Find the interface control that can handle a specific media format

Synopsis:

#include <aoi.h>

const AOICtrl_t *AoFindFormats(const AODataFormat_t *format,
                               int32_t *rating,
                               const char *interface,
                               int32_t version);

Arguments:

format
A pointer to a AODataFormat_t structure that specifies the media format you want to find the best interface control for.
rating
A pointer to where the function stores a returned rating, from 0 to 100, for the returned AOI control.
interface
The interface required in the control.
version
The minimum version of the interface required in the control.

Library:

libaoi.so

Description:

This function finds the control that has an AOFormatInspector interface that returns the best rating for the given format and has the given interface and version, if specified.

Returns:

The AOI control with the best rating for format, or NULL if no control is found.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

AODataFormat_t, AoFindExt(), AoFindMime(), AoFindName(), AoFindStreams()