Android中OpenMax的适配层

Android中的OpenMax适配层的接口在frameworks/base/include/media/目录中的IOMX.h文件定义，其内容如下所示：

class IOMX : public IInterface {
public:
    DECLARE_META_INTERFACE(OMX);
    typedef void *buffer_id;
    typedef void *node_id;
    virtual bool livesLocally(pid_t pid) = 0;
    struct ComponentInfo {                    // 组件的信息
        String8 mName;
        List < String8 >  mRoles;
    };
    virtual status_t listNodes(List < ComponentInfo >   *list) = 0;  // 节点列表
    virtual status_t allocateNode(
            const char *name, const sp < IOMXObserver >   &observer,  // 分配节点
            node_id *node) = 0;
    virtual status_t freeNode(node_id node) = 0;  // 找到节点
    virtual status_t sendCommand(               // 发送命令
            node_id node, OMX_COMMANDTYPE cmd, OMX_S32 param) = 0;
    virtual status_t getParameter(              // 获得参数
            node_id node, OMX_INDEXTYPE index,
            void *params, size_t size) = 0;
    virtual status_t setParameter(                // 设置参数
            node_id node, OMX_INDEXTYPE index,
            const void *params, size_t size) = 0;
    virtual status_t getConfig(                   // 获得配置
            node_id node, OMX_INDEXTYPE index,
            void *params, size_t size) = 0;
    virtual status_t setConfig(                  // 设置配置
            node_id node, OMX_INDEXTYPE index,
            const void *params, size_t size) = 0;
    virtual status_t useBuffer(                     // 使用缓冲区
            node_id node, OMX_U32 port_index, const  sp < IMemory >  &params,
            buffer_id *buffer) = 0;
    virtual status_t allocateBuffer(                 // 分配缓冲区
            node_id node, OMX_U32 port_index, size_t size,
            buffer_id *buffer, void **buffer_data) = 0;
    virtual status_t allocateBufferWithBackup(       // 分配带后备缓冲区
            node_id node, OMX_U32 port_index, const  sp < IMemory >  &params,
            buffer_id *buffer) = 0;
    virtual status_t freeBuffer(                       // 释放缓冲区
            node_id node, OMX_U32 port_index, buffer_id buffer) = 0;
    virtual status_t fillBuffer(node_id node,  buffer_id buffer) = 0; // 填充缓冲区
    virtual status_t emptyBuffer(                   // 消耗缓冲区
            node_id node,
            buffer_id buffer,
            OMX_U32 range_offset, OMX_U32 range_length,
            OMX_U32 flags, OMX_TICKS timestamp) = 0;
    virtual status_t getExtensionIndex(
            node_id node,
            const char *parameter_name,
            OMX_INDEXTYPE *index) = 0;
    virtual sp < IOMXRenderer >  createRenderer(        // 创建渲染器（从ISurface）
            const sp < ISurface >  &surface,
            const char *componentName,
            OMX_COLOR_FORMATTYPE colorFormat,
            size_t encodedWidth, size_t encodedHeight,
            size_t displayWidth, size_t displayHeight) = 0;
    sp < IOMXRenderer >  createRenderer(                 // 创建渲染器（从Surface）
            const sp < Surface >  &surface,
            const char *componentName,
            OMX_COLOR_FORMATTYPE colorFormat,
            size_t encodedWidth, size_t encodedHeight,
            size_t displayWidth, size_t displayHeight);
    sp < IOMXRenderer >  createRendererFromJavaSurface(     // 从Java层创建渲染器
            JNIEnv *env, jobject javaSurface,
            const char *componentName,
            OMX_COLOR_FORMATTYPE colorFormat,
            size_t encodedWidth, size_t encodedHeight,
            size_t displayWidth, size_t displayHeight);
};

IOMX表示的是OpenMax的一个组件，根据Android的Binder IPC机制，BnOMX继承IOMX，实现者需要继承实现BnOMX。IOMX类中，除了和标准的OpenMax的 GetParameter，SetParameter，GetConfig，SetConfig，SendCommand，UseBuffer，AllocateBuffer，FreeBuffer，FillThisBuffer 和EmptyThisBuffer等接口之外，还包含了创造渲染器的接口createRenderer()，创建的接口为IOMXRenderer类型。

IOMX中只有第一个createRenderer()函数是纯虚函数，第二个的createRenderer()函数和createRendererFromJavaSurface()通过调用第一个createRenderer()函数实现。

IOMXRenderer类表示一个OpenMax的渲染器，其定义如下所示：

class IOMXRenderer : public IInterface {
public:
    DECLARE_META_INTERFACE(OMXRenderer);
    virtual void render(IOMX::buffer_id  buffer) = 0;  // 渲染输出函数
};

IOMXRenderer只包含了一个render接口，其参数类型IOMX::buffer_id实际上是void*，根据不同渲染器使用不同的类型。

在IOMX.h文件中，另有表示观察器类的IOMXObserver，这个类表示OpenMax的观察者，其中只包含一个onMessage()函 数，其参数为omx_message接口体，其中包含Event事件类型、FillThisBuffer完成和EmptyThisBuffer完成几种类 型。

提示：Android中OpenMax的适配层是OpenMAX IL层至上的封装层，在Android系统中被StageFright调用，也可以被其他部分调用。

http://book.51cto.com/art/201101/243162.htm