mpegts: Update annotations

Specify whether the various functions can return a NULL value

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/8466>
This commit is contained in:
Edward Hervey 2025-02-12 10:37:09 +01:00 committed by GStreamer Marge Bot
parent fab7e43fe2
commit 03902c30de
7 changed files with 197 additions and 161 deletions

View file

@ -979,8 +979,9 @@ Consult the relevant specifications for more details.</doc>
</method>
<method name="get_event" c:identifier="gst_mpegts_dvb_linkage_descriptor_get_event">
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">The #GstMpegtsDVBLinkageEvent or %NULL if an error happened</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">The #GstMpegtsDVBLinkageEvent or %NULL
if an error happened</doc>
<type name="DVBLinkageEvent" c:type="const GstMpegtsDVBLinkageEvent*"/>
</return-value>
<parameters>
@ -992,8 +993,9 @@ Consult the relevant specifications for more details.</doc>
</method>
<method name="get_extended_event" c:identifier="gst_mpegts_dvb_linkage_descriptor_get_extended_event">
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">an #GstMpegtsDVBLinkageExtendedEvent array or %NULL if an error happened</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">an #GstMpegtsDVBLinkageExtendedEvent array or %NULL if an error
happened</doc>
<array name="GLib.PtrArray" c:type="const GPtrArray*">
<type name="DVBLinkageExtendedEvent"/>
</array>
@ -1007,8 +1009,9 @@ Consult the relevant specifications for more details.</doc>
</method>
<method name="get_mobile_hand_over" c:identifier="gst_mpegts_dvb_linkage_descriptor_get_mobile_hand_over">
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">The #GstMpegtsDVBLinkageMobileHandOver or %NULL if an error happened</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">The #GstMpegtsDVBLinkageMobileHandOver
or %NULL if an error happened</doc>
<type name="DVBLinkageMobileHandOver" c:type="const GstMpegtsDVBLinkageMobileHandOver*"/>
</return-value>
<parameters>
@ -2214,8 +2217,9 @@ See ISO/IEC 13818-1:2018 Section 2.6.62 and 2.6.63 for details.</doc>
<function name="from_custom" c:identifier="gst_mpegts_descriptor_from_custom">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">Creates a #GstMpegtsDescriptor with custom @tag and @data</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">#GstMpegtsDescriptor</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">#GstMpegtsDescriptor, or %NULL if input
is invalid</doc>
<type name="Descriptor" c:type="GstMpegtsDescriptor*"/>
</return-value>
<parameters>
@ -2268,8 +2272,9 @@ See ISO/IEC 13818-1:2018 Section 2.6.62 and 2.6.63 for details.</doc>
with the network name @name. The data field of the #GstMpegtsDescriptor
will be allocated, and transferred to the caller.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">the #GstMpegtsDescriptor or %NULL on fail</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">the #GstMpegtsDescriptor or %NULL on
failure.</doc>
<type name="Descriptor" c:type="GstMpegtsDescriptor*"/>
</return-value>
<parameters>
@ -2284,8 +2289,9 @@ will be allocated, and transferred to the caller.</doc>
The data field of the #GstMpegtsDescriptor will be allocated,
and transferred to the caller.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">the #GstMpegtsDescriptor or %NULL on fail</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">the #GstMpegtsDescriptor or %NULL on
failure</doc>
<type name="Descriptor" c:type="GstMpegtsDescriptor*"/>
</return-value>
<parameters>
@ -3917,9 +3923,9 @@ the section (i.e. the first byte should contain the `table_id` field).</doc>
<method name="get_atsc_cvct" c:identifier="gst_mpegts_section_get_atsc_cvct">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">Returns the #GstMpegtsAtscVCT contained in the @section</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">The #GstMpegtsAtscVCT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">The #GstMpegtsAtscVCT contained in the
section, or %NULL if an error happened.</doc>
<type name="AtscVCT" c:type="const GstMpegtsAtscVCT*"/>
</return-value>
<parameters>
@ -3962,9 +3968,9 @@ happened.</doc>
<method name="get_atsc_mgt" c:identifier="gst_mpegts_section_get_atsc_mgt">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">Returns the #GstMpegtsAtscMGT contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">The #GstMpegtsAtscMGT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">The #GstMpegtsAtscMGT contained in the
section, or %NULL if an error happened.</doc>
<type name="AtscMGT" c:type="const GstMpegtsAtscMGT*"/>
</return-value>
<parameters>
@ -4007,9 +4013,9 @@ happened.</doc>
<method name="get_atsc_tvct" c:identifier="gst_mpegts_section_get_atsc_tvct">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">Returns the #GstMpegtsAtscVCT contained in the @section</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">The #GstMpegtsAtscVCT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">The #GstMpegtsAtscVCT contained in the
section, or %NULL if an error happened.</doc>
<type name="AtscVCT" c:type="const GstMpegtsAtscVCT*"/>
</return-value>
<parameters>
@ -4022,9 +4028,9 @@ happened.</doc>
<method name="get_bat" c:identifier="gst_mpegts_section_get_bat">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Returns the #GstMpegtsBAT contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsBAT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsBAT contained in the
section, or %NULL if an error happened.</doc>
<type name="BAT" c:type="const GstMpegtsBAT*"/>
</return-value>
<parameters>
@ -4040,10 +4046,10 @@ happened.</doc>
Returns the array of #GstMpegtsDescriptor contained in the Conditional
Access Table.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="container">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The array
of #GstMpegtsDescriptor contained in the section, or %NULL if an error
happened. Release with #g_array_unref when done.</doc>
<return-value transfer-ownership="container" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">
The array of #GstMpegtsDescriptor contained in the section, or %NULL if an
error happened. Release with #g_array_unref when done.</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="Descriptor"/>
</array>
@ -4072,9 +4078,9 @@ happened. Release with #g_array_unref when done.</doc>
<method name="get_eit" c:identifier="gst_mpegts_section_get_eit">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Returns the #GstMpegtsEIT contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsEIT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsEIT contained in the
section, or %NULL if an error happened.</doc>
<type name="EIT" c:type="const GstMpegtsEIT*"/>
</return-value>
<parameters>
@ -4087,9 +4093,9 @@ happened.</doc>
<method name="get_nit" c:identifier="gst_mpegts_section_get_nit">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Returns the #GstMpegtsNIT contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsNIT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsNIT contained in the
section, or %NULL if an error happened.</doc>
<type name="NIT" c:type="const GstMpegtsNIT*"/>
</return-value>
<parameters>
@ -4107,11 +4113,11 @@ Returns the array of #GstMpegtsPatProgram contained in the section.
Note: The PAT `transport_stream_id` field corresponds to the
"subtable_extension" field of the provided @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="container">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The
#GstMpegtsPatProgram contained in the section, or %NULL if an error happened
or the @section did not contain a valid PAT. Release with #g_ptr_array_unref
when done.</doc>
<return-value transfer-ownership="container" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">
The #GstMpegtsPatProgram contained in the section, or %NULL if an error
happened or the @section did not contain a valid PAT. Release with
#g_ptr_array_unref when done.</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="PatProgram"/>
</array>
@ -4126,9 +4132,9 @@ when done.</doc>
<method name="get_pmt" c:identifier="gst_mpegts_section_get_pmt">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">Parses the Program Map Table contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The #GstMpegtsPMT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The #GstMpegtsPMT contained in the
section, or %NULL if an error happened.</doc>
<type name="PMT" c:type="const GstMpegtsPMT*"/>
</return-value>
<parameters>
@ -4141,9 +4147,9 @@ happened.</doc>
<method name="get_scte_sit" c:identifier="gst_mpegts_section_get_scte_sit">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">Returns the #GstMpegtsSCTESIT contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">The #GstMpegtsSCTESIT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">The #GstMpegtsSCTESIT contained in the
section, or %NULL if an error happened.</doc>
<type name="SCTESIT" c:type="const GstMpegtsSCTESIT*"/>
</return-value>
<parameters>
@ -4156,9 +4162,9 @@ happened.</doc>
<method name="get_sdt" c:identifier="gst_mpegts_section_get_sdt">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Returns the #GstMpegtsSDT contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsSDT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsSDT contained in the
section, or %NULL if an error happened.</doc>
<type name="SDT" c:type="const GstMpegtsSDT*"/>
</return-value>
<parameters>
@ -4171,9 +4177,9 @@ happened.</doc>
<method name="get_sit" c:identifier="gst_mpegts_section_get_sit" version="1.20">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Returns the #GstMpegtsSIT contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsSIT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsSIT contained in the
section, or %NULL if an error happened.</doc>
<type name="SIT" c:type="const GstMpegtsSIT*"/>
</return-value>
<parameters>
@ -4186,9 +4192,10 @@ happened.</doc>
<method name="get_tdt" c:identifier="gst_mpegts_section_get_tdt">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Returns the #GstDateTime of the TDT</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstDateTime contained in the section, or %NULL
if an error happened. Release with #gst_date_time_unref when done.</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstDateTime contained in the
section, or %NULL if an error happened. Release with #gst_date_time_unref
when done.</doc>
<type name="Gst.DateTime" c:type="GstDateTime*"/>
</return-value>
<parameters>
@ -4201,9 +4208,9 @@ if an error happened. Release with #gst_date_time_unref when done.</doc>
<method name="get_tot" c:identifier="gst_mpegts_section_get_tot">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Returns the #GstMpegtsTOT contained in the @section.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsTOT contained in the section, or %NULL if an error
happened.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">The #GstMpegtsTOT contained in the
section, or %NULL if an error happened.</doc>
<type name="TOT" c:type="const GstMpegtsTOT*"/>
</return-value>
<parameters>
@ -4218,10 +4225,10 @@ happened.</doc>
Returns the array of #GstMpegtsDescriptor contained in the section</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="container">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The array
of #GstMpegtsDescriptor contained in the section, or %NULL if an error
happened. Release with #g_array_unref when done.</doc>
<return-value transfer-ownership="container" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">
The array of #GstMpegtsDescriptor contained in the section, or %NULL if an
error happened. Release with #g_array_unref when done.</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="Descriptor"/>
</array>
@ -4272,10 +4279,11 @@ data field is allocated and populated.</doc>
</parameter>
</parameters>
</method>
<function name="from_atsc_mgt" c:identifier="gst_mpegts_section_from_atsc_mgt" version="1.18">
<function name="from_atsc_mgt" c:identifier="gst_mpegts_section_from_atsc_mgt">
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">the #GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">the #GstMpegtsSection, or %NULL if @mgt
is invalid Since: 1.18</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -4310,8 +4318,9 @@ data field is allocated and populated.</doc>
<function name="from_nit" c:identifier="gst_mpegts_section_from_nit">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Ownership of @nit is taken. The data in @nit is managed by the #GstMpegtsSection</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">the #GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">the #GstMpegtsSection, or %NULL if @nit
is invalid</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -4344,8 +4353,9 @@ data field is allocated and populated.</doc>
<function name="from_pmt" c:identifier="gst_mpegts_section_from_pmt">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">Creates a #GstMpegtsSection from @pmt that is bound to @pid</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">#GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">#GstMpegtsSection, or %NULL if @pmt is
invalid</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -4362,8 +4372,9 @@ data field is allocated and populated.</doc>
<function name="from_scte_sit" c:identifier="gst_mpegts_section_from_scte_sit">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">Ownership of @sit is taken. The data in @sit is managed by the #GstMpegtsSection</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">the #GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">the #GstMpegtsSection, or %NULL if @sit
is invalid</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -4379,8 +4390,9 @@ data field is allocated and populated.</doc>
<function name="from_sdt" c:identifier="gst_mpegts_section_from_sdt">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Ownership of @sdt is taken. The data in @sdt is managed by the #GstMpegtsSection</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">the #GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">the #GstMpegtsSection or %NULL if @sdt
is invalid</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -5103,8 +5115,9 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services</doc
<function name="descriptor_from_custom" c:identifier="gst_mpegts_descriptor_from_custom" moved-to="Descriptor.from_custom">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">Creates a #GstMpegtsDescriptor with custom @tag and @data</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">#GstMpegtsDescriptor</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">#GstMpegtsDescriptor, or %NULL if input
is invalid</doc>
<type name="Descriptor" c:type="GstMpegtsDescriptor*"/>
</return-value>
<parameters>
@ -5157,8 +5170,9 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services</doc
with the network name @name. The data field of the #GstMpegtsDescriptor
will be allocated, and transferred to the caller.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">the #GstMpegtsDescriptor or %NULL on fail</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">the #GstMpegtsDescriptor or %NULL on
failure.</doc>
<type name="Descriptor" c:type="GstMpegtsDescriptor*"/>
</return-value>
<parameters>
@ -5173,8 +5187,9 @@ will be allocated, and transferred to the caller.</doc>
The data field of the #GstMpegtsDescriptor will be allocated,
and transferred to the caller.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">the #GstMpegtsDescriptor or %NULL on fail</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-descriptor.c">the #GstMpegtsDescriptor or %NULL on
failure</doc>
<type name="Descriptor" c:type="GstMpegtsDescriptor*"/>
</return-value>
<parameters>
@ -5343,9 +5358,9 @@ a single language</doc>
<function name="event_parse_mpegts_section" c:identifier="gst_event_parse_mpegts_section">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">Extracts the #GstMpegtsSection contained in the @event #GstEvent</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The extracted #GstMpegtsSection , or %NULL if the
event did not contain a valid #GstMpegtsSection.</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The extracted #GstMpegtsSection , or
%NULL if the event did not contain a valid #GstMpegtsSection.</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -5361,8 +5376,9 @@ event did not contain a valid #GstMpegtsSection.</doc>
Note: To look for descriptors that can be present more than once in an
array of descriptors, iterate the #GArray manually.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">the first descriptor matching @tag, else %NULL.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">the first descriptor matching @tag, else
%NULL.</doc>
<type name="Descriptor" c:type="const GstMpegtsDescriptor*"/>
</return-value>
<parameters>
@ -5385,8 +5401,9 @@ of #GstMpegtsDescriptor</doc>
Note: To look for descriptors that can be present more than once in an
array of descriptors, iterate the #GArray manually.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.h"/>
<return-value transfer-ownership="none">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">the first descriptor matchin @tag with @tag_extension, else %NULL.</doc>
<return-value transfer-ownership="none" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">the first descriptor matchin @tag with
@tag_extension, else %NULL.</doc>
<type name="Descriptor" c:type="const GstMpegtsDescriptor*"/>
</return-value>
<parameters>
@ -5525,9 +5542,9 @@ usage.</doc>
<function name="message_new_mpegts_section" c:identifier="gst_message_new_mpegts_section">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">Creates a new #GstMessage for a @GstMpegtsSection.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The new #GstMessage to be posted, or %NULL if the
section is not valid.</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">The new #GstMessage to be posted, or
%NULL if the section is not valid.</doc>
<type name="Gst.Message" c:type="GstMessage*"/>
</return-value>
<parameters>
@ -5544,7 +5561,7 @@ section is not valid.</doc>
<function name="message_parse_mpegts_section" c:identifier="gst_message_parse_mpegts_section">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">Returns the #GstMpegtsSection contained in a message.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">the contained #GstMpegtsSection, or %NULL.</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
@ -5561,10 +5578,10 @@ array.
Note: The data provided in @buffer will not be copied.</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.h"/>
<return-value transfer-ownership="full">
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtsdescriptor.c">an
array of the parsed descriptors or %NULL if there was an error.
Release with #g_array_unref when done with it.</doc>
array of the parsed descriptors or %NULL if there was an error. Release with
#g_array_unref when done with it.</doc>
<array name="GLib.PtrArray" c:type="GPtrArray*">
<type name="Descriptor"/>
</array>
@ -5681,10 +5698,11 @@ If the @duration is 0 it won't be specified in the event.</doc>
</parameter>
</parameters>
</function>
<function name="section_from_atsc_mgt" c:identifier="gst_mpegts_section_from_atsc_mgt" moved-to="Section.from_atsc_mgt" version="1.18">
<function name="section_from_atsc_mgt" c:identifier="gst_mpegts_section_from_atsc_mgt" moved-to="Section.from_atsc_mgt">
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">the #GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-atsc-section.c">the #GstMpegtsSection, or %NULL if @mgt
is invalid Since: 1.18</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -5719,8 +5737,9 @@ If the @duration is 0 it won't be specified in the event.</doc>
<function name="section_from_nit" c:identifier="gst_mpegts_section_from_nit" moved-to="Section.from_nit">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Ownership of @nit is taken. The data in @nit is managed by the #GstMpegtsSection</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">the #GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">the #GstMpegtsSection, or %NULL if @nit
is invalid</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -5753,8 +5772,9 @@ If the @duration is 0 it won't be specified in the event.</doc>
<function name="section_from_pmt" c:identifier="gst_mpegts_section_from_pmt" moved-to="Section.from_pmt">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">Creates a #GstMpegtsSection from @pmt that is bound to @pid</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">#GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gstmpegtssection.c">#GstMpegtsSection, or %NULL if @pmt is
invalid</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -5771,8 +5791,9 @@ If the @duration is 0 it won't be specified in the event.</doc>
<function name="section_from_scte_sit" c:identifier="gst_mpegts_section_from_scte_sit" moved-to="Section.from_scte_sit">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">Ownership of @sit is taken. The data in @sit is managed by the #GstMpegtsSection</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">the #GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-scte-section.c">the #GstMpegtsSection, or %NULL if @sit
is invalid</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>
@ -5788,8 +5809,9 @@ If the @duration is 0 it won't be specified in the event.</doc>
<function name="section_from_sdt" c:identifier="gst_mpegts_section_from_sdt" moved-to="Section.from_sdt">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">Ownership of @sdt is taken. The data in @sdt is managed by the #GstMpegtsSection</doc>
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.h"/>
<return-value transfer-ownership="full">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">the #GstMpegtsSection</doc>
<return-value transfer-ownership="full" nullable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/mpegts/gst-dvb-section.c">the #GstMpegtsSection or %NULL if @sdt
is invalid</doc>
<type name="Section" c:type="GstMpegtsSection*"/>
</return-value>
<parameters>

View file

@ -255,8 +255,8 @@ error:
*
* Returns the #GstMpegtsAtscVCT contained in the @section
*
* Returns: The #GstMpegtsAtscVCT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsAtscVCT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsAtscVCT *
gst_mpegts_section_get_atsc_tvct (GstMpegtsSection * section)
@ -279,8 +279,8 @@ gst_mpegts_section_get_atsc_tvct (GstMpegtsSection * section)
*
* Returns the #GstMpegtsAtscVCT contained in the @section
*
* Returns: The #GstMpegtsAtscVCT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsAtscVCT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsAtscVCT *
gst_mpegts_section_get_atsc_cvct (GstMpegtsSection * section)
@ -521,8 +521,8 @@ _packetize_mgt (GstMpegtsSection * section)
* gst_mpegts_section_from_atsc_mgt:
* @mgt: (transfer full): a #GstMpegtsAtscMGT to create the #GstMpegtsSection from
*
* Returns: (transfer full): the #GstMpegtsSection
* Since: 1.18
* Returns: (transfer full) (nullable): the #GstMpegtsSection, or %NULL if @mgt
* is invalid Since: 1.18
*/
GstMpegtsSection *
gst_mpegts_section_from_atsc_mgt (GstMpegtsAtscMGT * mgt)
@ -548,8 +548,8 @@ gst_mpegts_section_from_atsc_mgt (GstMpegtsAtscMGT * mgt)
*
* Returns the #GstMpegtsAtscMGT contained in the @section.
*
* Returns: The #GstMpegtsAtscMGT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsAtscMGT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsAtscMGT *
gst_mpegts_section_get_atsc_mgt (GstMpegtsSection * section)

View file

@ -100,7 +100,8 @@ gst_mpegts_descriptor_parse_dvb_network_name (const GstMpegtsDescriptor *
* with the network name @name. The data field of the #GstMpegtsDescriptor
* will be allocated, and transferred to the caller.
*
* Returns: (transfer full): the #GstMpegtsDescriptor or %NULL on fail
* Returns: (transfer full) (nullable): the #GstMpegtsDescriptor or %NULL on
* failure.
*/
GstMpegtsDescriptor *
gst_mpegts_descriptor_from_dvb_network_name (const gchar * name)
@ -510,7 +511,8 @@ gst_mpegts_descriptor_parse_dvb_service (const GstMpegtsDescriptor *
* The data field of the #GstMpegtsDescriptor will be allocated,
* and transferred to the caller.
*
* Returns: (transfer full): the #GstMpegtsDescriptor or %NULL on fail
* Returns: (transfer full) (nullable): the #GstMpegtsDescriptor or %NULL on
* failure
*/
GstMpegtsDescriptor *
gst_mpegts_descriptor_from_dvb_service (GstMpegtsDVBServiceType service_type,
@ -839,7 +841,8 @@ fail:
* gst_mpegts_dvb_linkage_descriptor_get_mobile_hand_over:
* @desc: the #GstMpegtsDVBLinkageDescriptor
*
* Returns: The #GstMpegtsDVBLinkageMobileHandOver or %NULL if an error happened
* Returns: (transfer none) (nullable): The #GstMpegtsDVBLinkageMobileHandOver
* or %NULL if an error happened
*/
const GstMpegtsDVBLinkageMobileHandOver *
gst_mpegts_dvb_linkage_descriptor_get_mobile_hand_over (const
@ -856,7 +859,8 @@ gst_mpegts_dvb_linkage_descriptor_get_mobile_hand_over (const
* gst_mpegts_dvb_linkage_descriptor_get_event:
* @desc: the #GstMpegtsDVBLinkageDescriptor
*
* Returns: The #GstMpegtsDVBLinkageEvent or %NULL if an error happened
* Returns: (transfer none) (nullable): The #GstMpegtsDVBLinkageEvent or %NULL
* if an error happened
*/
const GstMpegtsDVBLinkageEvent *
gst_mpegts_dvb_linkage_descriptor_get_event (const GstMpegtsDVBLinkageDescriptor
@ -873,7 +877,9 @@ gst_mpegts_dvb_linkage_descriptor_get_event (const GstMpegtsDVBLinkageDescriptor
* gst_mpegts_dvb_linkage_descriptor_get_extended_event:
* @desc: the #GstMpegtsDVBLinkageDescriptor
*
* Returns: (element-type GstMpegtsDVBLinkageExtendedEvent): an #GstMpegtsDVBLinkageExtendedEvent array or %NULL if an error happened
* Returns: (element-type GstMpegtsDVBLinkageExtendedEvent) (transfer none)
* (nullable): an #GstMpegtsDVBLinkageExtendedEvent array or %NULL if an error
* happened
*/
const GPtrArray *
gst_mpegts_dvb_linkage_descriptor_get_extended_event (const

View file

@ -291,8 +291,8 @@ error:
*
* Returns the #GstMpegtsEIT contained in the @section.
*
* Returns: The #GstMpegtsEIT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsEIT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsEIT *
gst_mpegts_section_get_eit (GstMpegtsSection * section)
@ -466,8 +466,8 @@ error:
*
* Returns the #GstMpegtsBAT contained in the @section.
*
* Returns: The #GstMpegtsBAT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsBAT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsBAT *
gst_mpegts_section_get_bat (GstMpegtsSection * section)
@ -646,8 +646,8 @@ error:
*
* Returns the #GstMpegtsNIT contained in the @section.
*
* Returns: The #GstMpegtsNIT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsNIT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsNIT *
gst_mpegts_section_get_nit (GstMpegtsSection * section)
@ -805,7 +805,8 @@ _packetize_nit (GstMpegtsSection * section)
*
* Ownership of @nit is taken. The data in @nit is managed by the #GstMpegtsSection
*
* Returns: (transfer full): the #GstMpegtsSection
* Returns: (transfer full) (nullable): the #GstMpegtsSection, or %NULL if @nit
* is invalid
*/
GstMpegtsSection *
gst_mpegts_section_from_nit (GstMpegtsNIT * nit)
@ -973,8 +974,8 @@ error:
*
* Returns the #GstMpegtsSDT contained in the @section.
*
* Returns: The #GstMpegtsSDT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsSDT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsSDT *
gst_mpegts_section_get_sdt (GstMpegtsSection * section)
@ -1125,7 +1126,8 @@ _packetize_sdt (GstMpegtsSection * section)
*
* Ownership of @sdt is taken. The data in @sdt is managed by the #GstMpegtsSection
*
* Returns: (transfer full): the #GstMpegtsSection
* Returns: (transfer full) (nullable): the #GstMpegtsSection or %NULL if @sdt
* is invalid
*/
GstMpegtsSection *
gst_mpegts_section_from_sdt (GstMpegtsSDT * sdt)
@ -1162,8 +1164,9 @@ _parse_tdt (GstMpegtsSection * section)
*
* Returns the #GstDateTime of the TDT
*
* Returns: The #GstDateTime contained in the section, or %NULL
* if an error happened. Release with #gst_date_time_unref when done.
* Returns: (transfer full) (nullable): The #GstDateTime contained in the
* section, or %NULL if an error happened. Release with #gst_date_time_unref
* when done.
*/
GstDateTime *
gst_mpegts_section_get_tdt (GstMpegtsSection * section)
@ -1237,8 +1240,8 @@ _parse_tot (GstMpegtsSection * section)
*
* Returns the #GstMpegtsTOT contained in the @section.
*
* Returns: The #GstMpegtsTOT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsTOT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsTOT *
gst_mpegts_section_get_tot (GstMpegtsSection * section)
@ -1391,8 +1394,8 @@ error:
*
* Returns the #GstMpegtsSIT contained in the @section.
*
* Returns: The #GstMpegtsSIT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsSIT contained in the
* section, or %NULL if an error happened.
*
* Since: 1.20
*/

View file

@ -426,8 +426,8 @@ error:
*
* Returns the #GstMpegtsSCTESIT contained in the @section.
*
* Returns: The #GstMpegtsSCTESIT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsSCTESIT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsSCTESIT *
gst_mpegts_section_get_scte_sit (GstMpegtsSection * section)
@ -888,7 +888,8 @@ _packetize_sit (GstMpegtsSection * section)
*
* Ownership of @sit is taken. The data in @sit is managed by the #GstMpegtsSection
*
* Returns: (transfer full): the #GstMpegtsSection
* Returns: (transfer full) (nullable): the #GstMpegtsSection, or %NULL if @sit
* is invalid
*/
GstMpegtsSection *
gst_mpegts_section_from_scte_sit (GstMpegtsSCTESIT * sit, guint16 pid)

View file

@ -291,7 +291,7 @@ _encode_control_codes (gchar * text, gsize length, gboolean is_multibyte)
* If no character map that contains all characters could be found, the
* string is converted to ISO 6937 with unknown characters set to `?`.
*
* Returns: (transfer full): byte array of size @out_size
* Returns: (transfer full) (nullable): byte array of size @out_size
*/
guint8 *
dvb_text_from_utf8 (const gchar * text, gsize * out_size)
@ -744,9 +744,9 @@ G_DEFINE_BOXED_TYPE (GstMpegtsDescriptor, gst_mpegts_descriptor,
*
* Note: The data provided in @buffer will not be copied.
*
* Returns: (transfer full) (element-type GstMpegtsDescriptor): an
* array of the parsed descriptors or %NULL if there was an error.
* Release with #g_array_unref when done with it.
* Returns: (transfer full) (element-type GstMpegtsDescriptor) (nullable): an
* array of the parsed descriptors or %NULL if there was an error. Release with
* #g_array_unref when done with it.
*/
GPtrArray *
gst_mpegts_parse_descriptors (guint8 * buffer, gsize buf_len)
@ -830,7 +830,8 @@ gst_mpegts_parse_descriptors (guint8 * buffer, gsize buf_len)
* Note: To look for descriptors that can be present more than once in an
* array of descriptors, iterate the #GArray manually.
*
* Returns: (transfer none): the first descriptor matching @tag, else %NULL.
* Returns: (transfer none) (nullable): the first descriptor matching @tag, else
* %NULL.
*/
const GstMpegtsDescriptor *
gst_mpegts_find_descriptor (GPtrArray * descriptors, guint8 tag)
@ -859,7 +860,8 @@ gst_mpegts_find_descriptor (GPtrArray * descriptors, guint8 tag)
* Note: To look for descriptors that can be present more than once in an
* array of descriptors, iterate the #GArray manually.
*
* Returns: (transfer none): the first descriptor matchin @tag with @tag_extension, else %NULL.
* Returns: (transfer none) (nullable): the first descriptor matchin @tag with
* @tag_extension, else %NULL.
*
* Since: 1.20
*/
@ -1215,7 +1217,8 @@ gst_mpegts_descriptor_parse_logical_channel (const GstMpegtsDescriptor *
*
* Creates a #GstMpegtsDescriptor with custom @tag and @data
*
* Returns: #GstMpegtsDescriptor
* Returns: (transfer full) (nullable): #GstMpegtsDescriptor, or %NULL if input
* is invalid
*/
GstMpegtsDescriptor *
gst_mpegts_descriptor_from_custom (guint8 tag, const guint8 * data,
@ -1242,7 +1245,7 @@ gst_mpegts_descriptor_from_custom (guint8 tag, const guint8 * data,
*
* Creates a #GstMpegtsDescriptor with custom @tag, @tag_extension and @data
*
* Returns: #GstMpegtsDescriptor
* Returns: (transfer full): #GstMpegtsDescriptor
*
* Since: 1.20
*/

View file

@ -253,7 +253,7 @@ gst_mpegts_section_get_data (GstMpegtsSection * section)
*
* Returns the #GstMpegtsSection contained in a message.
*
* Returns: (transfer full): the contained #GstMpegtsSection, or %NULL.
* Returns: (transfer full) (nullable): the contained #GstMpegtsSection, or %NULL.
*/
GstMpegtsSection *
gst_message_parse_mpegts_section (GstMessage * message)
@ -329,8 +329,8 @@ _mpegts_section_get_structure (GstMpegtsSection * section)
*
* Creates a new #GstMessage for a @GstMpegtsSection.
*
* Returns: (transfer full): The new #GstMessage to be posted, or %NULL if the
* section is not valid.
* Returns: (transfer full) (nullable): The new #GstMessage to be posted, or
* %NULL if the section is not valid.
*/
GstMessage *
gst_message_new_mpegts_section (GstObject * parent, GstMpegtsSection * section)
@ -373,8 +373,8 @@ gst_event_new_mpegts_section (GstMpegtsSection * section)
*
* Extracts the #GstMpegtsSection contained in the @event #GstEvent
*
* Returns: (transfer full): The extracted #GstMpegtsSection , or %NULL if the
* event did not contain a valid #GstMpegtsSection.
* Returns: (transfer full) (nullable): The extracted #GstMpegtsSection , or
* %NULL if the event did not contain a valid #GstMpegtsSection.
*/
GstMpegtsSection *
gst_event_parse_mpegts_section (GstEvent * event)
@ -494,10 +494,10 @@ _parse_pat (GstMpegtsSection * section)
* Note: The PAT `transport_stream_id` field corresponds to the
* "subtable_extension" field of the provided @section.
*
* Returns: (transfer container) (element-type GstMpegtsPatProgram): The
* #GstMpegtsPatProgram contained in the section, or %NULL if an error happened
* or the @section did not contain a valid PAT. Release with #g_ptr_array_unref
* when done.
* Returns: (transfer container) (element-type GstMpegtsPatProgram) (nullable):
* The #GstMpegtsPatProgram contained in the section, or %NULL if an error
* happened or the @section did not contain a valid PAT. Release with
* #g_ptr_array_unref when done.
*/
GPtrArray *
gst_mpegts_section_get_pat (GstMpegtsSection * section)
@ -768,8 +768,8 @@ error:
*
* Parses the Program Map Table contained in the @section.
*
* Returns: The #GstMpegtsPMT contained in the section, or %NULL if an error
* happened.
* Returns: (transfer none) (nullable): The #GstMpegtsPMT contained in the
* section, or %NULL if an error happened.
*/
const GstMpegtsPMT *
gst_mpegts_section_get_pmt (GstMpegtsSection * section)
@ -930,7 +930,8 @@ _packetize_pmt (GstMpegtsSection * section)
*
* Creates a #GstMpegtsSection from @pmt that is bound to @pid
*
* Returns: (transfer full): #GstMpegtsSection
* Returns: (transfer full) (nullable): #GstMpegtsSection, or %NULL if @pmt is
* invalid
*/
GstMpegtsSection *
gst_mpegts_section_from_pmt (GstMpegtsPMT * pmt, guint16 pid)
@ -973,9 +974,9 @@ _parse_cat (GstMpegtsSection * section)
* Returns the array of #GstMpegtsDescriptor contained in the Conditional
* Access Table.
*
* Returns: (transfer container) (element-type GstMpegtsDescriptor): The array
* of #GstMpegtsDescriptor contained in the section, or %NULL if an error
* happened. Release with #g_array_unref when done.
* Returns: (transfer container) (element-type GstMpegtsDescriptor) (nullable):
* The array of #GstMpegtsDescriptor contained in the section, or %NULL if an
* error happened. Release with #g_array_unref when done.
*/
GPtrArray *
gst_mpegts_section_get_cat (GstMpegtsSection * section)
@ -1002,9 +1003,9 @@ gst_mpegts_section_get_cat (GstMpegtsSection * section)
*
* Returns the array of #GstMpegtsDescriptor contained in the section
*
* Returns: (transfer container) (element-type GstMpegtsDescriptor): The array
* of #GstMpegtsDescriptor contained in the section, or %NULL if an error
* happened. Release with #g_array_unref when done.
* Returns: (transfer container) (element-type GstMpegtsDescriptor) (nullable):
* The array of #GstMpegtsDescriptor contained in the section, or %NULL if an
* error happened. Release with #g_array_unref when done.
*/
GPtrArray *
gst_mpegts_section_get_tsdt (GstMpegtsSection * section)