mpp/inc/mpp_buffer.h

8  *      http://www.apache.org/licenses/LICENSE-2.0
38  *    buffer should attach to certain group, and buffer mode control the buffer usage flow.
51  *    it will support normal buffer, Android ion buffer, Linux v4l2 vb2 buffer
57  * mpp buffer group support two work flow mode:
59  * normal flow: all buffer are generated by MPP
60  *              under this mode, buffer pool is maintained internally
65  *              mpp_buffer_get(A)               return a    ref +1 -> used
67  *              mpp_buffer_put(a)                           ref -1
68  *              mpp_buffer_put(a)                           ref -1 -> unused
72  *              under this mode, buffers is commit by external api.
95  * mpp buffer group has two buffer limit mode: normal and limit
97  * normal mode: allows any buffer size and always general new buffer is no unused buffer
99  *              This mode normally use with normal flow and is used for table / stream buffer
101  * limit mode : restrict the buffer's size and count in the buffer group. if try to calloc
103  *              This mode normally use with commit flow and is used for frame buffer
107  * NOTE: normal mode is recommanded to work with normal flow, working with limit  mode is not.
108  *       limit  mode is recommanded to work with commit flow, working with normal mode is not.
119  * normal   : normal malloc buffer for unit test or hardware simulation
165  * index - the buffer index used to track buffer in buffer pool
166  * size  - the buffer size
170  * ptr  - virtual address of normal malloced buffer
171  * fd   - unused and set to -1, the allocator would return its
176  * ptr  - virtual address of ion buffer in user space
177  * hnd  - ion handle in user space
178  * fd   - ion buffer file handle for map / unmap
195  * 1. group - specified the MppBuffer to be attached to.
199  * 2. info  - input information for the output MppBuffer
202  * 3. buffer - generated MppBuffer from MppBufferInfo.
284  * mpp_buffer_import_with_tag - compounded interface for commit and import
305 MPP_RET mpp_buffer_group_get(MppBufferGroup *group, MppBufferType type, MppBufferMode mode,
315  * size  : 0 - no limit, other - max buffer size
316  * count : 0 - no limit, other - max buffer count