design: more STREAM_STATUS updates

Pass the thread object in a GValue, which would allow the application to figure
out the type of the object instead of us having to explicitly code it in a
message field.
This commit is contained in:
Wim Taymans 2009-04-21 13:34:18 +02:00 committed by Wim Taymans
parent 39aa1e0e31
commit 3ff09d9b51

View file

@ -61,7 +61,7 @@ Messages
The existing STREAM_STATUS message will be further defined and implemented in The existing STREAM_STATUS message will be further defined and implemented in
(selected) elements. The following fields will be contained in the message: (selected) elements. The following fields will be contained in the message:
- "status", GST_TYPE_STREAM_STATUS_TYPE - "type", GST_TYPE_STREAM_STATUS_TYPE
- a set of types to control the lifecycle of the thread: - a set of types to control the lifecycle of the thread:
GST_STREAM_STATUS_TYPE_CREATE: a new streaming thread is going to be GST_STREAM_STATUS_TYPE_CREATE: a new streaming thread is going to be
@ -77,17 +77,6 @@ Messages
GST_STREAM_STATUS_TYPE_PAUSE: a streaming thread is paused GST_STREAM_STATUS_TYPE_PAUSE: a streaming thread is paused
GST_STREAM_STATUS_TYPE_STOP: a streaming thread is stopped GST_STREAM_STATUS_TYPE_STOP: a streaming thread is stopped
- "thread-object-type", GST_TYPE_THREAD_OBJECT
The type of object used for controlling the streaming thread.
GST_STREAM_THREAD_TASK: thread-object contains a GstTask object
controlling the streaming
GST_STREAM_THREAD_GTHREAD: threadobject contains a GThread that controls
the streaming.
- "thread-object", GstTask/GThread
A GstTask/GThread controlling this streaming thread. This can be NULL when
the object controlling the streaming thread is not yet created.
- "owner", GST_TYPE_ELEMENT - "owner", GST_TYPE_ELEMENT
The owner element of the thread. The message source will contain the pad The owner element of the thread. The message source will contain the pad
(or one of the pads) that will produce data by this thread. If this thread (or one of the pads) that will produce data by this thread. If this thread
@ -96,6 +85,10 @@ Messages
element/pad what function this thread has in the context of the element/pad what function this thread has in the context of the
application and configure the thread appropriatly. application and configure the thread appropriatly.
- "object", G_TYPE, GstTask/GThread
A GstTask/GThread controlling this streaming thread. This can be NULL when
the object controlling the streaming thread is not yet created.
- "flow-return", GstFlowReturn - "flow-return", GstFlowReturn
A status code for why the thread state changed. when threads are created A status code for why the thread state changed. when threads are created
and started, this is usually GST_FLOW_OK but when they are stopping it and started, this is usually GST_FLOW_OK but when they are stopping it