## GstError

GstError — Categorized error messages

## Synopsis

    #include <gst/gst.h>

    enum        GstCoreError;
    enum        GstLibraryError;
    enum        GstResourceError;
    enum        GstStreamError;
    #define     GST_CORE_ERROR
    #define     GST_LIBRARY_ERROR
    #define     GST_RESOURCE_ERROR
    #define     GST_STREAM_ERROR
    #define     GST_ERROR_SYSTEM
    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);

## Description

## Details

### enum GstCoreError

    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;

Core errors are errors inside the core GStreamer library.

`GST_CORE_ERROR_FAILED` | a general error which doesn't fit in any other category. Make sure you add a custom message to the error call.
`GST_CORE_ERROR_TOO_LAZY` | do not use this except as a placeholder for deciding where to go while developing code.
`GST_CORE_ERROR_NOT_IMPLEMENTED` | use this when you do not want to implement this functionality yet.
`GST_CORE_ERROR_STATE_CHANGE` | used for state change errors.
`GST_CORE_ERROR_PAD` | used for pad-related errors.
`GST_CORE_ERROR_THREAD` | used for thread-related errors.
`GST_CORE_ERROR_SCHEDULER` | used for scheduler-related errors.
`GST_CORE_ERROR_NEGOTIATION` | used for negotiation-related errors.
`GST_CORE_ERROR_EVENT` | used for event-related errors.
`GST_CORE_ERROR_SEEK` | used for seek-related errors.
`GST_CORE_ERROR_CAPS` | used for caps-related errors.
`GST_CORE_ERROR_TAG` | used for negotiation-related errors.
`GST_CORE_ERROR_NUM_ERRORS` | the number of core error types.

### enum GstLibraryError

    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;

Library errors are for errors from the library being used by elements (initializing, finalizing, settings, ...)

`GST_LIBRARY_ERROR_FAILED` | a general error which doesn't fit in any other category. Make sure you add a custom message to the error call.
`GST_LIBRARY_ERROR_TOO_LAZY` | do not use this except as a placeholder for deciding where to go while developing code.
`GST_LIBRARY_ERROR_INIT` | used when the library could not be opened.
`GST_LIBRARY_ERROR_SHUTDOWN` | used when the library could not be closed.
`GST_LIBRARY_ERROR_SETTINGS` | used when the library doesn't accept settings.
`GST_LIBRARY_ERROR_ENCODE` | used when the library generated an encoding error.
`GST_LIBRARY_ERROR_NUM_ERRORS` | the number of library error types.

### enum GstResourceError

    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;

Resource errors are for any resource used by an element: memory, files, network connections, process space, ... They're typically used by source and sink elements.

`GST_RESOURCE_ERROR_FAILED` | a general error which doesn't fit in any other category. Make sure you add a custom message to the error call.
`GST_RESOURCE_ERROR_TOO_LAZY` | do not use this except as a placeholder for deciding where to go while developing code.
`GST_RESOURCE_ERROR_NOT_FOUND` | used when the resource could not be found.
`GST_RESOURCE_ERROR_BUSY` | used when resource is busy.
`GST_RESOURCE_ERROR_OPEN_READ` | used when resource fails to open for reading.
`GST_RESOURCE_ERROR_OPEN_WRITE` | used when resource fails to open for writing.
`GST_RESOURCE_ERROR_OPEN_READ_WRITE` | used when resource cannot be opened for both reading and writing, or either (but unspecified which).
`GST_RESOURCE_ERROR_CLOSE` | used when the resource can't be closed.
`GST_RESOURCE_ERROR_READ` | used when the resource can't be read from.
`GST_RESOURCE_ERROR_WRITE` | used when the resource can't be written to.
`GST_RESOURCE_ERROR_SEEK` | used when a seek on the resource fails.
`GST_RESOURCE_ERROR_SYNC` | used when a synchronize on the resource fails.
`GST_RESOURCE_ERROR_SETTINGS` | used when settings can't be manipulated on
`GST_RESOURCE_ERROR_NUM_ERRORS` | the number of library error types.

### enum GstStreamError

    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;

Stream errors are for anything related to the stream being processed: format errors, media type errors, ... They're typically used by decoders, demuxers, converters, ...

`GST_STREAM_ERROR_FAILED` | a general error which doesn't fit in any other category. Make sure you add a custom message to the error call.
`GST_STREAM_ERROR_TOO_LAZY` | do not use this except as a placeholder for deciding where to go while developing code.
`GST_STREAM_ERROR_NOT_IMPLEMENTED` | use this when you do not want to implement this functionality yet.
`GST_STREAM_ERROR_TYPE_NOT_FOUND` | used when the element doesn't know the stream's type.
`GST_STREAM_ERROR_WRONG_TYPE` | used when the element doesn't handle this type of stream.
`GST_STREAM_ERROR_CODEC_NOT_FOUND` | used when there's no codec to handle the stream's type.
`GST_STREAM_ERROR_DECODE` | used when decoding fails.
`GST_STREAM_ERROR_ENCODE` | used when encoding fails.
`GST_STREAM_ERROR_DEMUX` | used when demuxing fails.
`GST_STREAM_ERROR_MUX` | used when muxing fails.
`GST_STREAM_ERROR_FORMAT` | used when the stream is of the wrong format (for example, wrong caps).
`GST_STREAM_ERROR_NUM_ERRORS` | the number of library error types.

### GST_CORE_ERROR

    #define GST_CORE_ERROR      gst_core_error_quark ()

### GST_LIBRARY_ERROR

    #define GST_LIBRARY_ERROR   gst_library_error_quark ()

### GST_RESOURCE_ERROR

    #define GST_RESOURCE_ERROR  gst_resource_error_quark ()

### GST_STREAM_ERROR

    #define GST_STREAM_ERROR    gst_stream_error_quark ()

### GST_ERROR_SYSTEM

    #define GST_ERROR_SYSTEM    ("system error: %s", g_strerror (errno))

Generates an human readable error message out of an errno number.

### gst_error_get_message ()

    gchar*      gst_error_get_message           (GQuark domain,
                                                 gint code);

`domain` : | the GStreamer error domain this error belongs to.
`code` : | the error code belonging to the domain.
Returns : | a newly allocated string describing the error message in the current locale.

### gst_stream_error_quark ()

    GQuark      gst_stream_error_quark          (void);

Returns : |

### gst_core_error_quark ()

    GQuark      gst_core_error_quark            (void);

Returns : |

### gst_resource_error_quark ()

    GQuark      gst_resource_error_quark        (void);

Returns : |

### gst_library_error_quark ()

    GQuark      gst_library_error_quark         (void);

Returns : |