Create a new custom-typed event. This can be used for anything not handled by other event-specific functions to pass an event to another element.

Make sure to allocate an event type with the GST_EVENT_MAKE_TYPE macro, assigning a free number and filling in the correct direction and serialization flags.

New custom events can also be created by subclassing the event type if needed.


type GstEventType

The type of the new event

structure Structure

the structure for the event. The event will take ownership of the structure.

Return Value

the new custom event.


ConstructionException GTK+ fails to create the object.