audioencoder: Fix gst_audio_encoder_get_audio_info return ownership GTK-Doc
authorAlejandro González <alejandro.gonzalez.correo@gmail.com>
Sat, 13 Feb 2021 21:25:18 +0000 (21:25 +0000)
committerAlejandro González <alejandro.gonzalez.correo@gmail.com>
Sat, 13 Feb 2021 21:25:18 +0000 (21:25 +0000)
commit319da90d4cfdae6a5a84198d76a295dc8c162627
treead1f4738a46ce9187bfcf5632365f9cca18a602c
parent2fd2540ea58ffaa62921e83977f1cc80b73f6802
audioencoder: Fix gst_audio_encoder_get_audio_info return ownership GTK-Doc

GTK-Doc specifies that, by default, the caller owns returned objects, so that the caller should free them when it is done. However, in the case of this function, the returned GstAudioInfo is owned by the decoder, so this default choice is incorrect. This creates double free problems when using GStreamer Rust bindings, because they are generated using the information contained in the docs.

Fix this by correctly specifying that the caller does not own the returned object.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-base/-/merge_requests/1032>
gst-libs/gst/audio/gstaudioencoder.c