OpenMAX IL Loader Interface Overview

Purpose

The OpenMAX IL Loader interface is installed as an ECom plug-in between OpenMAX IL Core and OpenMAX IL Components on the Symbian platform. This ECom plug-in is loaded by OpenMAX IL Core to access OpenMAX IL Loader.

The OpenMAX IL Loader interface (entry point) is provided as a static library, and the ECom implementation is defined as a macro to allow OpenMAX IL Loader to be built as an ECom plug-in with very little overhead.

API name library details

You can choose either the Symbian OpenMAX IL Loader or a third-party OpenMAX IL Loader to load and unload OpenMAX IL Components. For Symbian OpenMAX IL Loader functionality you must adapt the following static library file.

Architectural relationship

The OpenMAX IL Loader interface interacts with OpenMAX IL Component: it is an ECom plug-in that loads and unloads OpenMAX IL Component.

KUidOmxILLoaderInterface is an identifier for the OpenMAX IL Loader interface.

Description

The OpenMAX IL Loader interface has the following two features:

• The OMX_LOADERTYPE structure

• The static library omxilsymbianloaderif.lib.

The OMX_LOADERTYPE structure

The functionality of the OMX_LOADERTYPE structure is to

• initialize OpenMAX IL Loader

• uninitialize OpenMAX IL Loader

• load OpenMAX IL Component

• unload OpenMAX IL Component

• detect a valid OpenMAX IL Component

• list the number of roles supported by OpenMAX IL Components

• list the number of OpenMAX IL Components that support a specific role.

Note: The OMX_LOADERTYPE structure is not a part of OpenMAX IL Specification 1.1.1, but follows its naming style to suggest the definition to The Khronos group for inclusion in OpenMAX IL Specification 1.1.1.

The static library omxilsymbianloaderif.lib

The static library omxilsymbianloaderif.lib has the following functionality:

• The library is installed as an ECom plug-in that implements the COmxComponentLoaderIf to run under OpenMAX IL Core. More detailed information is available in the OpenMAX IL Core Overview Architectural Relationship section.

• COmxComponentLoaderIf instantiates the OpenMAX IL Loader interface and gets the valid handle to the already populated OMX_LOADERTYPE structure during the load operation.

• COmxComponentLoaderIf deletes the OpenMAX IL Loader interface during the unload operation.

Key OpenMAX IL Loader interface classes

The key classes of the OpenMAX IL Loader interface are

• COmxComponentLoaderIf, which is an interface installed as an ECom plug-in to run under Symbian OpenMAX IL Core

• COmxSymbianLoaderIf, which is a Symbian implementation of OpenMAX IL Loader.

Using OpenMAX IL Loader interface

The OpenMAX IL Loader interface is mainly used to

• load OpenMAX IL Component

• unload OpenMAX IL Component

• list the number of roles supported by OpenMAX IL Component

• list the number of OpenMAX IL Components that support a specific role.