Android 13 - Media框架（14）- OpenMax（四）
这一节继续了解 openmax 目录下的内容。
1、OMX_Core.h
1.1、OMX_BUFFERHEADERTYPE
这是一个比较关键的结构体，上层ACodec/MediaCodec用到的 buffer id、OMXNode 与 OMX component 进行 buffer 传递都是通过该结构体完成，这里将会初步了解结构体中的部分成员意义：
OMX_U32 nSize：结构体的大小，用的不多；OMX_U8* pBuffer：指向真正存储数据的 buffer；OMX_U32 nAllocLen：分配的 buffer 的字节数；OMX_U32 nFilledLen：buffer中填充的数据的字节数；OMX_U32 nOffset：buffer 有效数据的偏移量；OMX_PTR pAppPrivate：指向应用层与之关联的 buffer；OMX_PTR pPlatformPrivate：指向平台与之关联的 buffer；OMX_PTR pInputPortPrivate：指向 input 端口与之关联的 buffer；OMX_PTR pOutputPortPrivate：指向 output 端口与之关联的 buffer；OMX_TICKS nTimeStamp：buffer 对应的 pts；OMX_U32 nFlags：buffer 所携带的标志位；OMX_U32 nOutputPortIndex：输出端口上的索引；OMX_U32 nInputPortIndex：输入端口上的索引；
结构体中 pBuffer、pAppPrivate、pPlatformPrivate 指向的内容这里暂时不做了解，后面了解 OMXNode 时再做研究。
1.2、OMX_EVENTTYPE
这个枚举类型定义了 OMX 组件的 callback 事件：
OMX_EventCmdComplete：组件执行完成一个命令；OMX_EventError：组件发生错误；OMX_EventMark：组件检测到 buffer 标识，用的较少；OMX_EventPortSettingsChanged：组件的端口设置发生变化；OMX_EventBufferFlag：组件收到 EOS；OMX_EventComponentResumed：组件恢复工作；OMX_EventOutputRendered：用作 tunnel mode 下 pts 上传给上层OMX_EventDataSpaceChanged：数据空间发生变化；OMX_EventOnFirstTunnelFrameReady：tunnel mode下第一帧被解出并且准备好渲染；
1.3、OMX_CALLBACKTYPE
这个结构体定义了 OMX 组件的 callback 类型，总共包含三个函数指针：
EventHandler：这个方法用于通知应用层OMX组件有事件发生；EmptyBufferDone：这个方法用于将 input 端口的使用完的（空的） buffer 返回给应用层；这个方法是阻塞调用的，所以应用层不应该再其他线程中填充这块buffer；FillBufferDone：这个方法用于将 output 端口的填充完的（满的）buffer 返回给应用层，同样的这个方法也是阻塞调用的；
1.4 OMX_BUFFERSUPPLIERTYPE
tunnel mode 相关，暂不了解。
2、OMX_Component.h
OMX_Component 头文件下定义了一个OMX组件所必要的公有接口，这个头文件将会被组件层和应用层共同使用。
2.1、struct OMX_PARAM_PORTDEFINITIONTYPE
每个组件都会有input 和 output 两个端口，每个端口都会有一个详细的信息描述，比如端口有几个buffer、端口当前的状态等等，这些信息就用 OMX_PARAM_PORTDEFINITIONTYPE来描述，结构体中有如下内容：
nPortIndex：端口的索引，使用较少；eDir：表示当前 port 是 input 还是 output；nBufferCountActual：当前端口上实际分配的buffer的数量；nBufferCountMin：当前端口最少应该分配的buffer的数量；nBufferSize：端口上每个buffer的大小；bEnabled：当前端口是否被使能，默认是 enabled；bPopulated：当前端口的数量是否已经被充满（数量等于nBufferCountActual），disable状态下端口将不会被认为是充满的；eDomain：当前端口中buffer存储的数据的类型，video数据还是audio数据，用于决定端口的format类型；format：表示端口中buffer的格式，不同数据类型对应于不同的格式，这将在后续了解；bBuffersContiguous：buffer是否连续；nBufferAlignment：buffer的对齐方式；
ACodec 中分配buffer时会先获取 port 定义，读取端口对应的 buffer 数量，后续也可能修改端口的buffer数量，另外读取输入输出格式时就是从端口定义的format中读取的。
2.2 struct OMX_COMPONENTTYPE
我们在OMX中见到的OMX_HANDLETYPE指代的就是这里的OMX_COMPONENTTYPE，它表示一个组件的句柄，通过这个句柄我们可以调用到组件的公有方法，也可以获取到组件的私有数据块（每个组件实现的方式与细节）。组件句柄由OMX Core创建，组件加载完成后，应用层可以安全的调用组件的方法。
接下来了解这个结构体中的部分内容：
pComponentPrivate：指向组件的私有数据块（内部实现）；pApplicationPrivate：指向OMX组件的调用者（client），也就是OMXNode；- 公有函数指针：由OMX组件实现，给client调用。
调用一个 OMX 方法后，组件的处理流程应该是这样：
- 调用 OMX_COMPONENTTYPE 的标准方法，传入参数为
OMX_COMPONENTTYPE自身； - 标准方法实现中对内部实现
pComponentPrivate进行处理和调用，比如说 SetCallbacks 应该会把回调函数注册给 pComponentPrivate 的一个成员。
OMX Core 创建的是一个基类对象，实际调用的是我们的子类实现，大致就是这个意思。