gstdevicemonitor.h 5.18 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130
/* GStreamer
 * Copyright (C) 2012 Olivier Crete <olivier.crete@collabora.com>
 *
 * gstdevicemonitor.h: Device probing and monitoring
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#include <gst/gstdevicemonitorfactory.h>


#ifndef __GST_DEVICE_MONITOR_H__
#define __GST_DEVICE_MONITOR_H__

#include <gst/gstelement.h>

G_BEGIN_DECLS

typedef struct _GstDeviceMonitor GstDeviceMonitor;
typedef struct _GstDeviceMonitorClass GstDeviceMonitorClass;
typedef struct _GstDeviceMonitorPrivate GstDeviceMonitorPrivate;

#define GST_TYPE_DEVICE_MONITOR                 (gst_device_monitor_get_type())
#define GST_IS_DEVICE_MONITOR(obj)              (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_DEVICE_MONITOR))
#define GST_IS_DEVICE_MONITOR_CLASS(klass)      (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_DEVICE_MONITOR))
#define GST_DEVICE_MONITOR_GET_CLASS(obj)       (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_DEVICE_MONITOR, GstDeviceMonitorClass))
#define GST_DEVICE_MONITOR(obj)                 (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_DEVICE_MONITOR, GstDeviceMonitor))
#define GST_DEVICE_MONITOR_CLASS(klass)         (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_DEVICE_MONITOR, GstDeviceMonitorClass))
#define GST_DEVICE_MONITOR_CAST(obj)            ((GstDeviceMonitor *)(obj))


struct _GstDeviceMonitor {
  GstObject         parent;

  /*< private >*/

  /* Protected by the Object lock */
  GList *devices;

  GstDeviceMonitorPrivate *priv;

  gpointer _gst_reserved[GST_PADDING];
};

/**
 * GstDeviceMonitorClass:
 * @factory: a pointer to the #GstDeviceMonitorFactory that creates this
 *  monitor
 * @get_devices: Returns a list of devices that are currently available.
 *  This should never block.
 * @start: Starts monitoring for new devices.
 * @stop: Stops monitoring for new devices
 *
 * The structure of the base #GstDeviceMonitorClass
 *
 * Since: 1.4
 */

struct _GstDeviceMonitorClass {
  GstObjectClass    parent_class;

  GstDeviceMonitorFactory     *factory;

  GList*      (*probe) (GstDeviceMonitor * monitor);

  gboolean    (*start) (GstDeviceMonitor * monitor);
  void        (*stop)  (GstDeviceMonitor * monitor);


  gpointer metadata;

  /*< private >*/
  gpointer _gst_reserved[GST_PADDING];
};

GType       gst_device_monitor_get_type (void);


GList *     gst_device_monitor_get_devices    (GstDeviceMonitor * monitor);

gboolean    gst_device_monitor_start          (GstDeviceMonitor * monitor);
void        gst_device_monitor_stop           (GstDeviceMonitor * monitor);

gboolean    gst_device_monitor_can_monitor    (GstDeviceMonitor * monitor);

GstBus *    gst_device_monitor_get_bus        (GstDeviceMonitor * monitor);

void        gst_device_monitor_device_add     (GstDeviceMonitor * monitor,
                                               GstDevice * device);
void        gst_device_monitor_device_remove  (GstDeviceMonitor * monitor,
                                               GstDevice * device);


/* device monitor class meta data */
void        gst_device_monitor_class_set_metadata          (GstDeviceMonitorClass *klass,
                                                            const gchar     *longname,
                                                            const gchar     *classification,
                                                            const gchar     *description,
                                                            const gchar     *author);
void        gst_device_monitor_class_set_static_metadata   (GstDeviceMonitorClass *klass,
                                                            const gchar     *longname,
                                                            const gchar     *classification,
                                                            const gchar     *description,
                                                            const gchar     *author);
void        gst_device_monitor_class_add_metadata          (GstDeviceMonitorClass * klass,
                                                            const gchar * key, const gchar * value);
void        gst_device_monitor_class_add_static_metadata   (GstDeviceMonitorClass * klass,
                                                            const gchar * key, const gchar * value);
const gchar * gst_device_monitor_class_get_metadata        (GstDeviceMonitorClass * klass,
                                                              const gchar * key);

/* factory management */
GstDeviceMonitorFactory * gst_device_monitor_get_factory   (GstDeviceMonitor * monitor);

G_END_DECLS

#endif /* __GST_DEVICE_MONITOR_H__ */