event/query/message: Annotate get_structure() return value as nullable

diff --git a/gst/gstevent.c b/gst/gstevent.c
index 207388a..71cfab0 100644 (file)
--- a/gst/gstevent.c
+++ b/gst/gstevent.c
@@ -333,9 +333,9 @@ had_parent:
  *
  * Access the structure of the event.
  *
- * Returns: The structure of the event. The structure is still
- * owned by the event, which means that you should not free it and
- * that the pointer becomes invalid when you free the event.
+ * Returns: (transfer none) (nullable): The structure of the event. The
+ * structure is still owned by the event, which means that you should not free
+ * it and that the pointer becomes invalid when you free the event.
  *
  * MT safe.
  */

diff --git a/gst/gstmessage.c b/gst/gstmessage.c
index 5f36662..33cf220 100644 (file)
--- a/gst/gstmessage.c
+++ b/gst/gstmessage.c
@@ -1144,9 +1144,9 @@ gst_message_new_request_state (GstObject * src, GstState state)
  *
  * Access the structure of the message.
  *
- * Returns: (transfer none): The structure of the message. The structure is
- * still owned by the message, which means that you should not free it and
- * that the pointer becomes invalid when you free the message.
+ * Returns: (transfer none) (nullable): The structure of the message. The
+ * structure is still owned by the message, which means that you should not
+ * free it and that the pointer becomes invalid when you free the message.
  *
  * MT safe.
  */

diff --git a/gst/gstquery.c b/gst/gstquery.c
index dd4929b..30180cf 100644 (file)
--- a/gst/gstquery.c
+++ b/gst/gstquery.c
@@ -705,9 +705,9 @@ had_parent:
  *
  * Get the structure of a query.
  *
- * Returns: (transfer none): the #GstStructure of the query. The structure is
- *     still owned by the query and will therefore be freed when the query
- *     is unreffed.
+ * Returns: (transfer none) (nullable): the #GstStructure of the query. The
+ *     structure is still owned by the query and will therefore be freed when the
+ *     query is unreffed.
  */
 const GstStructure *
 gst_query_get_structure (GstQuery * query)