mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-06-16 13:00:41 +00:00
09141c6e1f
Since we started depending on GLib 2.44, we can be sure this macro is defined (it will be a no-op on compilers that don't support it). For plugins we should just start using `G_DECLARE_FINAL_TYPE` which means we no longer need the macro there, but for most types in core we don't want to break ABI, which means it's better to just keep it like it is (and use the `#ifdef` instead).
121 lines
3.7 KiB
C
121 lines
3.7 KiB
C
/* GStreamer
|
|
* Copyright (C) 2012 Olivier Crete <olivier.crete@collabora.com>
|
|
*
|
|
* gstdevice.c: Device discovery
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
|
|
#ifndef __GST_DEVICE_H__
|
|
#define __GST_DEVICE_H__
|
|
|
|
typedef struct _GstDevice GstDevice;
|
|
typedef struct _GstDeviceClass GstDeviceClass;
|
|
|
|
#include <gst/gstelement.h>
|
|
#include <gst/gstcaps.h>
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
typedef struct _GstDevicePrivate GstDevicePrivate;
|
|
|
|
#define GST_TYPE_DEVICE (gst_device_get_type())
|
|
#define GST_IS_DEVICE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_DEVICE))
|
|
#define GST_IS_DEVICE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_DEVICE))
|
|
#define GST_DEVICE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_DEVICE, GstDeviceClass))
|
|
#define GST_DEVICE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_DEVICE, GstDevice))
|
|
#define GST_DEVICE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_DEVICE, GstDeviceClass))
|
|
#define GST_DEVICE_CAST(obj) ((GstDevice *)(obj))
|
|
|
|
/**
|
|
* GstDevice:
|
|
* @parent: The parent #GstObject structure.
|
|
*
|
|
* A device object.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
|
|
struct _GstDevice {
|
|
GstObject parent;
|
|
|
|
/*< private >*/
|
|
GstDevicePrivate *priv;
|
|
|
|
gpointer _gst_reserved[GST_PADDING];
|
|
};
|
|
|
|
/**
|
|
* GstDeviceClass:
|
|
* @parent_class: The parent #GstObjectClass structure.
|
|
* @create_element: Creates the fully configured element to access this device.
|
|
* Subclasses need to override this and return a new element.
|
|
* @reconfigure_element: This only needs to be implemented by subclasses if the
|
|
* element can be reconfigured to use a different device. See the documentation
|
|
* for gst_device_reconfigure_element().
|
|
*
|
|
* The class structure for a #GstDevice object.
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
|
|
struct _GstDeviceClass {
|
|
GstObjectClass parent_class;
|
|
|
|
GstElement * (*create_element) (GstDevice * device, const gchar * name);
|
|
gboolean (*reconfigure_element) (GstDevice * device, GstElement * element);
|
|
|
|
/*< private >*/
|
|
gpointer _gst_reserved[GST_PADDING];
|
|
};
|
|
|
|
GST_API
|
|
GType gst_device_get_type (void);
|
|
|
|
GST_API
|
|
GstElement * gst_device_create_element (GstDevice * device, const gchar * name);
|
|
|
|
GST_API
|
|
GstCaps * gst_device_get_caps (GstDevice * device);
|
|
|
|
GST_API
|
|
gchar * gst_device_get_display_name (GstDevice * device);
|
|
|
|
GST_API
|
|
gchar * gst_device_get_device_class (GstDevice * device);
|
|
|
|
GST_API
|
|
GstStructure * gst_device_get_properties (GstDevice * device);
|
|
|
|
GST_API
|
|
gboolean gst_device_reconfigure_element (GstDevice * device,
|
|
GstElement * element);
|
|
GST_API
|
|
gboolean gst_device_has_classesv (GstDevice * device,
|
|
gchar ** classes);
|
|
GST_API
|
|
gboolean gst_device_has_classes (GstDevice * device,
|
|
const gchar * classes);
|
|
|
|
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstDevice, gst_object_unref)
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GST_DEVICE_H__ */
|