API: add GST_MESSAGE_SRC_NAME macro

Add GST_MESSAGE_SRC_NAME macro that always returns a non-NULL string.
Useful for debugging and logging purposes.
This commit is contained in:
Tim-Philipp Müller 2009-06-03 21:10:39 +01:00
parent 92984a116b
commit 604097bc3a
2 changed files with 12 additions and 0 deletions

View file

@ -1092,6 +1092,7 @@ gst_iterator_result_get_type
GstMessage GstMessage
GstMessageType GstMessageType
GST_MESSAGE_SRC GST_MESSAGE_SRC
GST_MESSAGE_SRC_NAME
GST_MESSAGE_TIMESTAMP GST_MESSAGE_TIMESTAMP
GST_MESSAGE_TYPE GST_MESSAGE_TYPE
GST_MESSAGE_TYPE_NAME GST_MESSAGE_TYPE_NAME

View file

@ -182,6 +182,17 @@ typedef enum
* Get the object that posted @message. * Get the object that posted @message.
*/ */
#define GST_MESSAGE_SRC(message) (GST_MESSAGE(message)->src) #define GST_MESSAGE_SRC(message) (GST_MESSAGE(message)->src)
/**
* GST_MESSAGE_SRC_NAME:
* @message: a #GstMessage
*
* Get the name of the object that posted @message. Returns "(NULL)" if
* the message has no source object set.
*
* Since: 0.10.24
*/
#define GST_MESSAGE_SRC_NAME(message) (GST_MESSAGE_SRC(message) ? \
GST_OBJECT_NAME (GST_MESSAGE_SRC(message)) : "(NULL)")
/** /**
* GstStructureChangeType: * GstStructureChangeType: