/* GStreamer * Copyright (C) 2004 Thomas Vander Stichele * * 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_ERROR_H__ #define __GST_ERROR_H__ #include #include #include G_BEGIN_DECLS /* * we define FIXME error domains: * GST_CORE_ERROR * GST_LIBRARY_ERROR * GST_RESOURCE_ERROR * GST_STREAM_ERROR * * Check GError API docs for rationale for naming. */ /** * GstCoreError: * @GST_CORE_ERROR_FAILED: GStreamer encountered a general core library error. * @GST_CORE_ERROR_TOO_LAZY: GStreamer developers were too lazy to assign an error code to this error. Please file a bug. * @GST_CORE_ERROR_NOT_IMPLEMENTED: Internal GStreamer error: code not implemented. File a bug. * @GST_CORE_ERROR_STATE_CHANGE: Internal GStreamer error: state change failed. File a bug. * @GST_CORE_ERROR_PAD: Internal GStreamer error: pad problem. File a bug. * @GST_CORE_ERROR_THREAD: Internal GStreamer error: thread problem. File a bug. * @GST_CORE_ERROR_SCHEDULER: Internal GStreamer error: scheduler problem. File a bug. * @GST_CORE_ERROR_NEGOTIATION: Internal GStreamer error: negotiation problem. File a bug. * @GST_CORE_ERROR_EVENT: Internal GStreamer error: event problem. File a bug. * @GST_CORE_ERROR_SEEK: Internal GStreamer error: seek problem. File a bug. * @GST_CORE_ERROR_CAPS: Internal GStreamer error: caps problem. File a bug. * @GST_CORE_ERROR_TAG: Internal GStreamer error: tag problem. File a bug. * @GST_CORE_ERROR_NUM_ERRORS: the error count * * Core errors are anything that can go wrong in or using * the core GStreamer library */ /* FIXME: should we divide in numerical blocks so we can easily add for example PAD errors later ? */ typedef enum { GST_CORE_ERROR_FAILED = 1, GST_CORE_ERROR_TOO_LAZY, GST_CORE_ERROR_NOT_IMPLEMENTED, GST_CORE_ERROR_STATE_CHANGE, GST_CORE_ERROR_PAD, GST_CORE_ERROR_THREAD, GST_CORE_ERROR_SCHEDULER, GST_CORE_ERROR_NEGOTIATION, GST_CORE_ERROR_EVENT, GST_CORE_ERROR_SEEK, GST_CORE_ERROR_CAPS, GST_CORE_ERROR_TAG, GST_CORE_ERROR_NUM_ERRORS } GstCoreError; /** * GstLibraryError: * @GST_LIBRARY_ERROR_FAILED: GStreamer encountered a general supporting library error. * @GST_LIBRARY_ERROR_TOO_LAZY: GStreamer developers were too lazy to assign an error code to this error. Please file a bug. * @GST_LIBRARY_ERROR_INIT: Could not initialize supporting library. * @GST_LIBRARY_ERROR_SHUTDOWN: Could not close supporting library. * @GST_LIBRARY_ERROR_SETTINGS: Could not close supporting library. * @GST_LIBRARY_ERROR_ENCODE: * @GST_LIBRARY_ERROR_NUM_ERRORS: the error count * * Library errors are for errors from the library being used by elements * initializing, closing, ... */ typedef enum { GST_LIBRARY_ERROR_FAILED = 1, GST_LIBRARY_ERROR_TOO_LAZY, GST_LIBRARY_ERROR_INIT, GST_LIBRARY_ERROR_SHUTDOWN, GST_LIBRARY_ERROR_SETTINGS, GST_LIBRARY_ERROR_ENCODE, GST_LIBRARY_ERROR_NUM_ERRORS } GstLibraryError; /** * GstResourceError: * @GST_RESOURCE_ERROR_FAILED: GStreamer encountered a general resource error * @GST_RESOURCE_ERROR_TOO_LAZY: GStreamer developers were too lazy to assign an error code to this error. Please file a bug. * @GST_RESOURCE_ERROR_NOT_FOUND: Resource not found * @GST_RESOURCE_ERROR_BUSY: Resource busy or not available * @GST_RESOURCE_ERROR_OPEN_READ: Could not open resource for reading * @GST_RESOURCE_ERROR_OPEN_WRITE: Could not open resource for writing * @GST_RESOURCE_ERROR_OPEN_READ_WRITE: Could not open resource for reading and writing * @GST_RESOURCE_ERROR_CLOSE: Could not close resource * @GST_RESOURCE_ERROR_READ: Could not read from resource * @GST_RESOURCE_ERROR_WRITE: Could not write to resource * @GST_RESOURCE_ERROR_SEEK: Could not perform seek on resource * @GST_RESOURCE_ERROR_SYNC: Could not synchronize on resource * @GST_RESOURCE_ERROR_SETTINGS: Could not get/set settings from/on resource * @GST_RESOURCE_ERROR_NUM_ERRORS: the error count * * Resource errors are for anything external used by an element: * memory, files, network connections, process space, ... * They're typically used by source and sink elements */ typedef enum { GST_RESOURCE_ERROR_FAILED = 1, GST_RESOURCE_ERROR_TOO_LAZY, GST_RESOURCE_ERROR_NOT_FOUND, GST_RESOURCE_ERROR_BUSY, GST_RESOURCE_ERROR_OPEN_READ, GST_RESOURCE_ERROR_OPEN_WRITE, GST_RESOURCE_ERROR_OPEN_READ_WRITE, GST_RESOURCE_ERROR_CLOSE, GST_RESOURCE_ERROR_READ, GST_RESOURCE_ERROR_WRITE, GST_RESOURCE_ERROR_SEEK, GST_RESOURCE_ERROR_SYNC, GST_RESOURCE_ERROR_SETTINGS, GST_RESOURCE_ERROR_NUM_ERRORS } GstResourceError; /** * GstStreamError: * @GST_STREAM_ERROR_FAILED: GStreamer encountered a general stream error * @GST_STREAM_ERROR_TOO_LAZY: GStreamer developers were too lazy to assign an error code to this error. Please file a bug * @GST_STREAM_ERROR_NOT_IMPLEMENTED: Element doesn't implement handling of this stream. Please file a bug. * @GST_STREAM_ERROR_TYPE_NOT_FOUND: Could not determine type of stream * @GST_STREAM_ERROR_WRONG_TYPE: The stream is of a different type than handled by this element * @GST_STREAM_ERROR_CODEC_NOT_FOUND: There is no codec present that can handle the stream's type * @GST_STREAM_ERROR_DECODE: Could not decode stream * @GST_STREAM_ERROR_ENCODE: Could not encode stream * @GST_STREAM_ERROR_DEMUX: Could not demultiplex stream * @GST_STREAM_ERROR_MUX: Could not multiplex stream * @GST_STREAM_ERROR_FORMAT: Stream is of the wrong format * @GST_STREAM_ERROR_NUM_ERRORS: the error count * * Stream errors are for anything related to the stream being processed: * format errors, media type errors, ... * They're typically used by decoders, demuxers, converters, ... */ typedef enum { GST_STREAM_ERROR_FAILED = 1, GST_STREAM_ERROR_TOO_LAZY, GST_STREAM_ERROR_NOT_IMPLEMENTED, GST_STREAM_ERROR_TYPE_NOT_FOUND, GST_STREAM_ERROR_WRONG_TYPE, GST_STREAM_ERROR_CODEC_NOT_FOUND, GST_STREAM_ERROR_DECODE, GST_STREAM_ERROR_ENCODE, GST_STREAM_ERROR_DEMUX, GST_STREAM_ERROR_MUX, GST_STREAM_ERROR_FORMAT, GST_STREAM_ERROR_NUM_ERRORS } GstStreamError; /* This should go away once we convinced glib people to register GError */ #define GST_TYPE_G_ERROR (gst_g_error_get_type ()) #define GST_LIBRARY_ERROR gst_library_error_quark () #define GST_RESOURCE_ERROR gst_resource_error_quark () #define GST_CORE_ERROR gst_core_error_quark () #define GST_STREAM_ERROR gst_stream_error_quark () #define GST_ERROR_SYSTEM ("system error: %s", g_strerror (errno)) GType gst_g_error_get_type (void); gchar *gst_error_get_message (GQuark domain, gint code); GQuark gst_stream_error_quark (void); GQuark gst_core_error_quark (void); GQuark gst_resource_error_quark (void); GQuark gst_library_error_quark (void); G_END_DECLS #endif /* __GST_ERROR_H__ */