diff options
author | Edward Hervey <edward@centricular.com> | 2017-12-05 18:20:34 +0100 |
---|---|---|
committer | Edward Hervey <bilboed@bilboed.com> | 2017-12-05 18:20:34 +0100 |
commit | eb6ba249c43a0c6ecdad0a6aa3b3e56e9eebee84 (patch) | |
tree | 3cfacf58f4f5fac20de02bd1e084313c71ed76c8 | |
parent | e5c15f6b9605a1e682a60ea1bfadae831e651a41 (diff) |
docs: Add documentation for GST_SEQNUM_INVALID
And link to it
-rw-r--r-- | docs/gst/gstreamer-sections.txt | 1 | ||||
-rw-r--r-- | gst/gstutils.c | 2 | ||||
-rw-r--r-- | gst/gstutils.h | 10 |
3 files changed, 12 insertions, 1 deletions
diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt index 52443e18f..f850d582e 100644 --- a/docs/gst/gstreamer-sections.txt +++ b/docs/gst/gstreamer-sections.txt @@ -3571,6 +3571,7 @@ GFLOAT_FROM_LE GFLOAT_SWAP_LE_BE GFLOAT_TO_BE GFLOAT_TO_LE +GST_SEQNUM_INVALID GST_GROUP_ID_INVALID gst_guint64_to_gdouble diff --git a/gst/gstutils.c b/gst/gstutils.c index be45dec0f..447fcf87d 100644 --- a/gst/gstutils.c +++ b/gst/gstutils.c @@ -788,7 +788,7 @@ gst_util_uint64_scale_int_ceil (guint64 val, gint num, gint denom) * on a segment-done message to be the same as that of the last seek event, to * indicate that event and the message correspond to the same segment. * - * This function never returns GST_SEQNUM_INVALID (which is 0). + * This function never returns %GST_SEQNUM_INVALID (which is 0). * * Returns: A constantly incrementing 32-bit unsigned integer, which might * overflow at some point. Use gst_util_seqnum_compare() to make sure diff --git a/gst/gstutils.h b/gst/gstutils.h index a9b9eee88..50540961a 100644 --- a/gst/gstutils.h +++ b/gst/gstutils.h @@ -99,6 +99,16 @@ guint64 gst_util_uint64_scale_int_round (guint64 val, gint num, gint den GST_EXPORT guint64 gst_util_uint64_scale_int_ceil (guint64 val, gint num, gint denom); +/** + * GST_SEQNUM_INVALID: + * + * A value which is guaranteed to never be returned by + * gst_util_seqnum_next(). + * + * Can be used as a default value in variables used to store seqnum. + * + * Since: 1.14 + */ #define GST_SEQNUM_INVALID (0) GST_EXPORT |