FFmpeg
|
#include <stdatomic.h>
#include <stdint.h>
#include <string.h>
#include "refstruct.h"
#include "avassert.h"
#include "error.h"
#include "macros.h"
#include "mem.h"
#include "mem_internal.h"
#include "thread.h"
Go to the source code of this file.
Data Structures | |
struct | RefCount |
struct | AVRefStructPool |
AVRefStructPool is an API for a thread-safe pool of objects managed via the RefStruct API. More... | |
Macros | |
#define | ASSERT_LEVEL 0 |
#define | REFSTRUCT_CHECKED (ASSERT_LEVEL >= 1) |
#define | ff_assert(cond) ((void)0) |
#define | REFSTRUCT_COOKIE |
#define | REFCOUNT_OFFSET FFALIGN(sizeof(RefCount), ALIGN_64) |
#define | COMMON_FLAGS AV_REFSTRUCT_POOL_FLAG_NO_ZEROING |
Functions | |
static RefCount * | get_refcount (void *obj) |
static const RefCount * | cget_refcount (const void *obj) |
static void * | get_userdata (void *buf) |
static void | refcount_init (RefCount *ref, AVRefStructOpaque opaque, void(*free_cb)(AVRefStructOpaque opaque, void *obj)) |
void * | av_refstruct_alloc_ext_c (size_t size, unsigned flags, AVRefStructOpaque opaque, void(*free_cb)(AVRefStructOpaque opaque, void *obj)) |
Allocate a refcounted object of usable size size managed via the RefStruct API. More... | |
void | av_refstruct_unref (void *objp) |
Decrement the reference count of the underlying object and automatically free the object if there are no more references to it. More... | |
void * | av_refstruct_ref (void *obj) |
Create a new reference to an object managed via this API, i.e. More... | |
const void * | av_refstruct_ref_c (const void *obj) |
Analog of av_refstruct_ref(), but for constant objects. More... | |
void | av_refstruct_replace (void *dstp, const void *src) |
Ensure *dstp refers to the same object as src. More... | |
int | av_refstruct_exclusive (const void *obj) |
Check whether the reference count of an object managed via this API is 1. More... | |
static void | pool_free (AVRefStructPool *pool) |
static void | pool_free_entry (AVRefStructPool *pool, RefCount *ref) |
static void | pool_return_entry (void *ref_) |
static void | pool_reset_entry (AVRefStructOpaque opaque, void *entry) |
static int | refstruct_pool_get_ext (void *datap, AVRefStructPool *pool) |
void * | av_refstruct_pool_get (AVRefStructPool *pool) |
Get an object from the pool, reusing an old one from the pool when available. More... | |
static void | pool_unref (void *ref) |
Hint: The content of pool_unref() and refstruct_pool_uninit() could currently be merged; they are only separate functions in case we would ever introduce weak references. More... | |
static void | refstruct_pool_uninit (AVRefStructOpaque unused, void *obj) |
AVRefStructPool * | av_refstruct_pool_alloc (size_t size, unsigned flags) |
Equivalent to av_refstruct_pool_alloc(size, flags, NULL, NULL, NULL, NULL, NULL) More... | |
AVRefStructPool * | av_refstruct_pool_alloc_ext_c (size_t size, unsigned flags, AVRefStructOpaque opaque, int(*init_cb)(AVRefStructOpaque opaque, void *obj), void(*reset_cb)(AVRefStructOpaque opaque, void *obj), void(*free_entry_cb)(AVRefStructOpaque opaque, void *obj), void(*free_cb)(AVRefStructOpaque opaque)) |
Allocate an AVRefStructPool, potentially using complex callbacks. More... | |
#define ASSERT_LEVEL 0 |
Definition at line 34 of file refstruct.c.
#define REFSTRUCT_CHECKED (ASSERT_LEVEL >= 1) |
Definition at line 36 of file refstruct.c.
#define ff_assert | ( | cond | ) | ((void)0) |
Definition at line 42 of file refstruct.c.
#define REFSTRUCT_COOKIE |
Definition at line 51 of file refstruct.c.
#define COMMON_FLAGS AV_REFSTRUCT_POOL_FLAG_NO_ZEROING |
|
static |
Definition at line 70 of file refstruct.c.
Referenced by av_refstruct_pool_alloc_ext_c(), av_refstruct_ref(), av_refstruct_ref_c(), av_refstruct_unref(), pool_free(), and refstruct_pool_get_ext().
|
static |
Definition at line 77 of file refstruct.c.
Referenced by av_refstruct_exclusive().
|
static |
Definition at line 84 of file refstruct.c.
Referenced by av_refstruct_alloc_ext_c(), pool_free_entry(), pool_unref(), and refstruct_pool_get_ext().
|
static |
Definition at line 89 of file refstruct.c.
Referenced by av_refstruct_alloc_ext_c().
void* av_refstruct_alloc_ext_c | ( | size_t | size, |
unsigned | flags, | ||
AVRefStructOpaque | opaque, | ||
void(*)(AVRefStructOpaque opaque, void *obj) | free_cb | ||
) |
Allocate a refcounted object of usable size size
managed via the RefStruct API.
By default (in the absence of flags to the contrary), the returned object is initially zeroed.
size | Desired usable size of the returned object. |
flags | A bitwise combination of av_refstruct_FLAG_* flags. |
opaque | A pointer that will be passed to the free_cb callback. |
free_cb | A callback for freeing this object's content when its reference count reaches zero; it must not free the object itself. |
Definition at line 102 of file refstruct.c.
Referenced by av_refstruct_alloc_ext(), and cbs_alloc_content().
void av_refstruct_unref | ( | void * | objp | ) |
Decrement the reference count of the underlying object and automatically free the object if there are no more references to it.
*objp == NULL
is legal and a no-op.
objp | Pointer to a pointer that is either NULL or points to an object managed via this API. *objp is set to NULL on return. |
Definition at line 120 of file refstruct.c.
Referenced by alf_free(), alloc_and_insert_node(), alloc_progress(), aps_decode_alf(), aps_decode_scaling(), av1_decode_free(), av1_frame_unref(), av_container_fifo_drain(), av_container_fifo_free(), av_container_fifo_read(), av_container_fifo_write(), av_refstruct_pool_uninit(), av_refstruct_replace(), cbs_av1_close(), cbs_av1_write_obu(), cbs_clone_noncomplex_unit_content(), cbs_free_user_data_registered(), cbs_free_user_data_unregistered(), cbs_h2645_replace_ps(), cbs_h264_close(), cbs_h264_flush(), cbs_h265_close(), cbs_h265_flush(), cbs_h266_flush(), cbs_read_fragment_content(), cbs_sei_delete_message(), cbs_unit_uninit(), decode_pps(), decode_sps(), dts2pts_filter(), ff_cbs_make_unit_writable(), ff_cbs_sei_free_message_list(), ff_codec_close(), ff_decode_internal_uninit(), ff_dovi_ctx_flush(), ff_dovi_ctx_unref(), ff_dovi_rpu_generate(), ff_dovi_rpu_parse(), ff_ffv1_close(), ff_frame_thread_free(), ff_h2645_sei_message_decode(), ff_h2645_sei_reset(), ff_h264_decode_picture_parameter_set(), ff_h264_decode_seq_parameter_set(), ff_h264_ps_uninit(), ff_h264_unref_picture(), ff_hevc_decode_nal_pps(), ff_hevc_decode_nal_sps(), ff_hevc_decode_nal_vps(), ff_hevc_ps_uninit(), ff_hevc_unref_frame(), ff_lcevc_unref(), ff_mpv_encode_end(), ff_mpv_unref_picture(), ff_nvdec_decode_uninit(), ff_nvdec_start_frame_sep_ref(), ff_progress_frame_get_buffer(), ff_progress_frame_unref(), ff_qsv_enc_close(), ff_qsv_init_session_frames(), ff_thread_get_ext_buffer(), ff_thread_release_ext_buffer(), ff_v4l2_m2m_codec_end(), ff_v4l2_m2m_create_context(), ff_vk_decode_uninit(), ff_vvc_ctu_free_cus(), ff_vvc_frame_ps_free(), ff_vvc_ps_uninit(), ff_vvc_unref_frame(), free_node(), hevc_decode_free(), hevc_pps_free(), hevc_sps_free(), load_input_picture(), mpv_pic_reset(), nvdec_decoder_create(), nvdec_fdd_priv_free(), nvdec_unmap_mapped_frame(), pps_alloc(), pps_free(), qsv_decode_close_qsvcontext(), qsv_frame_alloc(), qsv_frame_free(), read_header(), remove_pps(), remove_sps(), remove_vps(), rkmpp_close_decoder(), rkmpp_release_frame(), select_input_picture(), set_bframe_chain_length(), set_sps(), slices_free(), sps_alloc(), sps_free(), update_frame_pool(), v4l2_free_buffer(), vaapi_encode_discard(), vaapi_encode_get_coded_data(), vaapi_encode_issue(), vaapi_encode_output(), vp3_decode_end(), vp8_alloc_frame(), vp8_release_frame(), vp9_frame_unref(), vulkan_decode_bootstrap(), wavpack_decode_block(), and wv_dsd_reset().
void* av_refstruct_ref | ( | void * | obj | ) |
Create a new reference to an object managed via this API, i.e.
increment the reference count of the underlying object and return obj.
Definition at line 140 of file refstruct.c.
Referenced by attach_post_process_data(), cbs_av1_write_obu(), ff_cbs_insert_unit_content(), ff_cbs_sei_add_message(), ff_nvdec_start_frame(), ff_progress_frame_ref(), ff_thread_ref_frame(), get_current_frame(), hevc_ref_frame(), qsv_setup_mids(), rkmpp_retrieve_frame(), v4l2_buf_increase_ref(), and vaapi_encode_output().
const void* av_refstruct_ref_c | ( | const void * | obj | ) |
Analog of av_refstruct_ref(), but for constant objects.
Definition at line 149 of file refstruct.c.
Referenced by alloc_frame(), alloc_picture(), av_refstruct_replace(), ff_h264_decode_picture_parameter_set(), ff_hevc_decode_nal_pps(), ff_hevc_parse_sps(), hevc_ref_frame(), and set_sps().
void av_refstruct_replace | ( | void * | dstp, |
const void * | src | ||
) |
Ensure *dstp
refers to the same object as src.
If *dstp
is already equal to src, do nothing. Otherwise unreference *dstp
and replace it with a new reference to src in case src != NULL
(this involves incrementing the reference count of src's underlying object) or with NULL otherwise.
dstp | Pointer to a pointer that is either NULL or points to an object managed via this API. |
src | A pointer to an object managed via this API or NULL. |
Definition at line 160 of file refstruct.c.
Referenced by aps_decode_alf(), aps_decode_scaling(), av1_frame_replace(), av1_receive_frame_internal(), cbs_av1_read_unit(), cbs_h2645_replace_ps(), cbs_h266_replace_ph(), decode_frame_ps(), decode_ph(), ff_decode_internal_sync(), ff_dovi_ctx_replace(), ff_h2645_sei_ctx_replace(), ff_h264_update_thread_context(), ff_mpv_replace_picture(), ff_mpv_workpic_from_pic(), ff_thread_replace_frame(), ff_thread_sync_ref(), ff_vk_update_thread_context(), ff_vvc_decode_aps(), ff_vvc_decode_sh(), h264_copy_picture_params(), h264_init_ps(), hevc_frame_start(), hevc_ref_frame(), parse_nal_units(), pps_alloc(), ref_frame(), slice_start(), sps_alloc(), update_context_from_thread(), and vp9_frame_replace().
int av_refstruct_exclusive | ( | const void * | obj | ) |
Check whether the reference count of an object managed via this API is 1.
obj | A pointer to an object managed via this API. |
Definition at line 174 of file refstruct.c.
Referenced by ff_cbs_make_unit_writable().
|
static |
Definition at line 208 of file refstruct.c.
Referenced by av_buffer_pool_init2(), pool_return_entry(), and pool_unref().
|
static |
Definition at line 216 of file refstruct.c.
Referenced by pool_return_entry(), and refstruct_pool_uninit().
|
static |
Definition at line 223 of file refstruct.c.
Referenced by refstruct_pool_get_ext().
|
static |
Definition at line 243 of file refstruct.c.
Referenced by refstruct_pool_get_ext().
|
static |
Definition at line 250 of file refstruct.c.
Referenced by av_refstruct_pool_get().
void* av_refstruct_pool_get | ( | AVRefStructPool * | pool | ) |
Get an object from the pool, reusing an old one from the pool when available.
Every call to this function must happen before av_refstruct_pool_uninit(). Otherwise undefined behaviour may occur.
pool | the pool from which to get the object |
Definition at line 297 of file refstruct.c.
Referenced by alloc_and_insert_node(), alloc_cu(), alloc_frame(), alloc_picture(), alloc_tu(), av_container_fifo_write(), ff_nvdec_start_frame(), ff_nvdec_start_frame_sep_ref(), ff_progress_frame_alloc(), load_input_picture(), vaapi_encode_issue(), vp9_frame_alloc(), and wavpack_decode_block().
|
static |
Hint: The content of pool_unref() and refstruct_pool_uninit() could currently be merged; they are only separate functions in case we would ever introduce weak references.
Definition at line 309 of file refstruct.c.
Referenced by av_refstruct_pool_alloc_ext_c().
|
static |
Definition at line 316 of file refstruct.c.
Referenced by av_refstruct_pool_alloc_ext_c().
AVRefStructPool* av_refstruct_pool_alloc | ( | size_t | size, |
unsigned | flags | ||
) |
Equivalent to av_refstruct_pool_alloc(size, flags, NULL, NULL, NULL, NULL, NULL)
Definition at line 335 of file refstruct.c.
Referenced by dts2pts_init(), frame_context_init(), h264_init_context(), init_table_pools(), pic_arrays_init(), and vp9_frame_alloc().
AVRefStructPool* av_refstruct_pool_alloc_ext_c | ( | size_t | size, |
unsigned | flags, | ||
AVRefStructOpaque | opaque, | ||
int(*)(AVRefStructOpaque opaque, void *obj) | init_cb, | ||
void(*)(AVRefStructOpaque opaque, void *obj) | reset_cb, | ||
void(*)(AVRefStructOpaque opaque, void *obj) | free_entry_cb, | ||
void(*)(AVRefStructOpaque opaque) | free_cb | ||
) |
Allocate an AVRefStructPool, potentially using complex callbacks.
size | size of the entries of the pool |
flags | a bitwise combination of av_refstruct_POOL_FLAG_* flags |
opaque | A pointer that will be passed to the callbacks below. |
init | A callback that will be called directly after a new entry has been allocated. obj has already been zeroed unless the av_refstruct_POOL_FLAG_NO_ZEROING flag is in use. |
reset | A callback that will be called after an entry has been returned to the pool and before it is reused. |
free_entry | A callback that will be called when an entry is freed after the pool has been marked as to be uninitialized. |
free | A callback that will be called when the pool itself is freed (after the last entry has been returned and freed). |
Definition at line 340 of file refstruct.c.
Referenced by av_refstruct_pool_alloc_ext().