memory: Deprecate GST_MEMORY_FLAG_NO_SHARE

This flag always causes problems as it prevents subbuffering,
instead one should create a custom GstAllocator to pool the GstMemory objects
and not rely on the lifetime of the GstBuffer object they were originally
attached to.

https://bugzilla.gnome.org/show_bug.cgi?id=757254

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/614>
This commit is contained in:
Olivier Crête 2017-07-11 18:54:05 -04:00 committed by GStreamer Merge Bot
parent 3393b456e4
commit e9c99c05ae

View file

@ -47,7 +47,10 @@ typedef struct _GstAllocator GstAllocator;
* @GST_MEMORY_FLAG_READONLY: memory is readonly. It is not allowed to map the * @GST_MEMORY_FLAG_READONLY: memory is readonly. It is not allowed to map the
* memory with #GST_MAP_WRITE. * memory with #GST_MAP_WRITE.
* @GST_MEMORY_FLAG_NO_SHARE: memory must not be shared. Copies will have to be * @GST_MEMORY_FLAG_NO_SHARE: memory must not be shared. Copies will have to be
* made when this memory needs to be shared between buffers. * made when this memory needs to be shared between buffers. (DEPRECATED:
* do not use in new code, instead you should create a custom GstAllocator for
* memory pooling instead of relying on the GstBuffer they were originally
* attached to.)
* @GST_MEMORY_FLAG_ZERO_PREFIXED: the memory prefix is filled with 0 bytes * @GST_MEMORY_FLAG_ZERO_PREFIXED: the memory prefix is filled with 0 bytes
* @GST_MEMORY_FLAG_ZERO_PADDED: the memory padding is filled with 0 bytes * @GST_MEMORY_FLAG_ZERO_PADDED: the memory padding is filled with 0 bytes
* @GST_MEMORY_FLAG_PHYSICALLY_CONTIGUOUS: the memory is physically contiguous. (Since: 1.2) * @GST_MEMORY_FLAG_PHYSICALLY_CONTIGUOUS: the memory is physically contiguous. (Since: 1.2)