ICodecCallback
概述
Codec回调接口定义。
提供了以下3种回调函数:
-
组件错误事件、命令完成事件、端口设置等事件回调，详见EventHandler。
-
输入端口处理完buffer回调，详见EmptyBufferDone。
-
输出端口填充完buffer回调，详见FillBufferDone。 通过以下两种方式注册回调:
-
创建组件时，通过CreateComponent方法。
-
当组件处于OMX_StateLoaded状态时，通过SetCallbacks方法注册回调。
起始版本： 4.1
相关模块：Codec
汇总
Public 成员函数
| 名称 | 描述 |
|---|---|
| EventHandler ([in] enum OMX_EVENTTYPE event, [in] struct EventInfo info) | 事件上报。 |
| EmptyBufferDone ([in] long appData, [in] struct OmxCodecBuffer buffer) | 上报输入buffer编码或者解码处理完毕。 |
| FillBufferDone ([in] long appData, [in] struct OmxCodecBuffer buffer) | 上报输出buffer填充完毕。 |
成员函数说明
EmptyBufferDone()
ICodecCallback::EmptyBufferDone ([in] long appData, [in] struct OmxCodecBuffer buffer )
描述 上报输入buffer编码或者解码处理完毕。
组件运行过程中向上报告输入buffer已经使用完毕。
起始版本： 4.1
参数:
| 名称 | 描述 |
|---|---|
| appData | 上层数据，通常是设置回调时给入的上层实例。 |
| buffer | 已经处理完毕的输入buffer信息OmxCodecBuffer。 |
返回：
HDF_SUCCESS 表示上报成功。
HDF_ERR_INVALID_PARAM 表示参数无效，上报失败。
HDF_FAILURE 表示执行失败。
其他值表示底层返回失败，具体错误码详见OpenMAX IL定义的OMX_ERRORTYPE。
EventHandler()
ICodecCallback::EventHandler ([in] enum OMX_EVENTTYPE event, [in] struct EventInfo info )
描述 事件上报。
组件运行过程中向上报告错误事件、命令完成事件、端口设置更改事件等。
-
当eEvent为OMX_EventCmdComplete，eventData为NULL，data1数据为OMX_COMMANDTYPE, 此时，当data1为OMX_CommandStateSet，data2表示状态，其它情况下，data2表示端口。
-
当event为OMX_EventError时，data1表示错误码，data2和eventData都为0。
-
当event为OMX_EventMark时，data1和data2都为0，eventData指向mark指针。
-
当event为OMX_EventPortSettingsChanged时，data1表示端口，data2和eventData为0。
-
当event为OMX_EventBufferFlag时，data1表示端口，data2表示flag，eventData为0。
-
当event为OMX_EventResourcesAcquired或OMX_EventDynamicResourcesAvailable时，data1、data2和eventData都为0。
起始版本： 4.1
参数:
| 名称 | 描述 |
|---|---|
| event | 要通知的事件类型，详见OMX_EVENTTYPE。 |
| info | 指向事件上报携带的信息指针，详见EventInfo。 |
返回：
HDF_SUCCESS 表示事件上报成功。
HDF_ERR_INVALID_PARAM 表示参数无效，事件上报失败。
HDF_FAILURE 表示执行失败。
其他值表示底层返回失败，具体错误码详见OpenMAX IL定义的OMX_ERRORTYPE。
FillBufferDone()
ICodecCallback::FillBufferDone ([in] long appData, [in] struct OmxCodecBuffer buffer )
描述 上报输出buffer填充完毕。
组件运行过程中向上报告输出buffer已经填充完毕。
起始版本： 4.1
参数:
| 名称 | 描述 |
|---|---|
| appData | 上层数据，通常是设置回调时给入的上层实例。 |
| buffer | 已经填充完毕的buffer信息OmxCodecBuffer。 |
返回：
HDF_SUCCESS 表示上报成功。
HDF_ERR_INVALID_PARAM 表示参数无效，上报失败。
HDF_FAILURE 表示执行失败。
其他值表示底层返回失败，具体错误码详见OpenMAX IL定义的OMX_ERRORTYPE。