[gst-devel] convention about event handling functions

[Wim Taymans]

On Thu, 2007-06-07 at 17:22 +0200, SP GLE wrote:
> Hi,
> When registering a GstPadEventFunction with
> gst_pad_set_event_function() on pad, what are the required properties
> of the passed eventfunc() ::
> 
> - Does eventfunc() HAVE TO take ownership of passed event ?

yes.

> - When/Why the eventfunc() should return TRUE or FALSE ?

TRUE when the event was handled successfully, this means the element
understood the event, no downstream/upstream pad was unlinked, etc..
FALSE in any other case.

>   - When returning TRUE, is the passed event supposed to have been
> unreffed  inside eventfunc() ?
>   - When returning FALSE, is the passed event supposed to have the same
> refcount as the one it had when passed to eventfunc() (leave untouched)
> or should it be decreased (unreffed)?

The function takes ownership of the event regardless of the return
value. After calling the function, the event is unreffed in all cases.

Wim

> 
> Regards.
> 
> 
> 
> 
> 
> 	
> 
> 	
> 		
> ___________________________________________________________________________ 
> Découvrez une nouvelle façon d'obtenir des réponses à toutes vos questions ! 
> Profitez des connaissances, des opinions et des expériences des internautes sur Yahoo! Questions/Réponses 
> http://fr.answers.yahoo.com
> 
> -------------------------------------------------------------------------
> This SF.net email is sponsored by DB2 Express
> Download DB2 Express C - the FREE version of DB2 express and take
> control of your XML. No limits. Just data. Click to get it now.
> http://sourceforge.net/powerbar/db2/
> _______________________________________________
> gstreamer-devel mailing list
> gstreamer-devel at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/gstreamer-devel