media: add lock to protect state changes
[platform/upstream/gstreamer.git] / gst / rtsp-server / rtsp-session-media.h
1 /* GStreamer
2  * Copyright (C) 2008 Wim Taymans <wim.taymans at gmail.com>
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Library General Public
6  * License as published by the Free Software Foundation; either
7  * version 2 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Library General Public License for more details.
13  *
14  * You should have received a copy of the GNU Library General Public
15  * License along with this library; if not, write to the
16  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
17  * Boston, MA 02110-1301, USA.
18  */
19
20 #include <gst/gst.h>
21
22 #include <gst/rtsp/gstrtsptransport.h>
23
24 #ifndef __GST_RTSP_SESSION_MEDIA_H__
25 #define __GST_RTSP_SESSION_MEDIA_H__
26
27 G_BEGIN_DECLS
28
29 #define GST_TYPE_RTSP_SESSION_MEDIA              (gst_rtsp_session_media_get_type ())
30 #define GST_IS_RTSP_SESSION_MEDIA(obj)           (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_RTSP_SESSION_MEDIA))
31 #define GST_IS_RTSP_SESSION_MEDIA_CLASS(klass)   (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_RTSP_SESSION_MEDIA))
32 #define GST_RTSP_SESSION_MEDIA_GET_CLASS(obj)    (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_RTSP_SESSION_MEDIA, GstRTSPSessionMediaClass))
33 #define GST_RTSP_SESSION_MEDIA(obj)              (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_RTSP_SESSION_MEDIA, GstRTSPSessionMedia))
34 #define GST_RTSP_SESSION_MEDIA_CLASS(klass)      (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_RTSP_SESSION_MEDIA, GstRTSPSessionMediaClass))
35 #define GST_RTSP_SESSION_MEDIA_CAST(obj)         ((GstRTSPSessionMedia*)(obj))
36 #define GST_RTSP_SESSION_MEDIA_CLASS_CAST(klass) ((GstRTSPSessionMediaClass*)(klass))
37
38 typedef struct _GstRTSPSessionMedia GstRTSPSessionMedia;
39 typedef struct _GstRTSPSessionMediaClass GstRTSPSessionMediaClass;
40
41 /**
42  * GstRTSPSessionMedia:
43  * @url: the url of the media
44  * @media: the pipeline for the media
45  * @state: the server state
46  * @counter: counter for channels
47  * @transports: array of #GstRTSPStreamTransport with the configuration
48  *   for the transport for each selected stream from @media.
49  *
50  * State of a client session regarding a specific media identified by uri.
51  */
52 struct _GstRTSPSessionMedia
53 {
54   GObject  parent;
55
56   GMutex        lock;
57   GstRTSPUrl   *url;
58   GstRTSPMedia *media;
59   GstRTSPState  state;
60   guint         counter;
61
62   GPtrArray    *transports;
63 };
64
65 struct _GstRTSPSessionMediaClass
66 {
67   GObjectClass  parent_class;
68 };
69
70 GType                    gst_rtsp_session_media_get_type       (void);
71
72 GstRTSPSessionMedia *    gst_rtsp_session_media_new            (const GstRTSPUrl *url,
73                                                                 GstRTSPMedia *media);
74 /* control media */
75 gboolean                 gst_rtsp_session_media_set_state      (GstRTSPSessionMedia *media,
76                                                                 GstState state);
77
78 /* get stream transport config */
79 GstRTSPStreamTransport * gst_rtsp_session_media_set_transport  (GstRTSPSessionMedia *media,
80                                                                 GstRTSPStream *stream,
81                                                                 GstRTSPTransport *tr);
82 GstRTSPStreamTransport * gst_rtsp_session_media_get_transport  (GstRTSPSessionMedia *media,
83                                                                 guint idx);
84
85 gboolean                 gst_rtsp_session_media_alloc_channels (GstRTSPSessionMedia *media,
86                                                                 GstRTSPRange *range);
87
88 G_END_DECLS
89
90 #endif /* __GST_RTSP_SESSION_MEDIA_H__ */