<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>gstreamermm: Gst::CoreError Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespaceGst.html">Gst</a>::<a class="el" href="classGst_1_1CoreError.html">CoreError</a>
</div>
</div>
<div class="contents">
<h1>Gst::CoreError Class Reference</h1><!-- doxytag: class="Gst::CoreError" --><!-- doxytag: inherits="Glib::Error" -->
<p>The GStreamer core GError type. <a href="#_details">More...</a></p>
<p>Inherits <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1Error.html">Glib::Error</a>.</p>
<div class="dynheader">
Collaboration diagram for Gst::CoreError:</div>
<div class="dynsection">
<div class="center"><img src="classGst_1_1CoreError__coll__graph.png" border="0" usemap="#Gst_1_1CoreError_coll__map" alt="Collaboration graph"/></div>
<map name="Gst_1_1CoreError_coll__map" id="Gst_1_1CoreError_coll__map">
<area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Error.html" title="Glib::Error" alt="" coords="20,83,100,112"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Exception.html" title="Glib::Exception" alt="" coords="5,5,115,35"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGst_1_1CoreError-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640f">Code</a> { <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640faca4338de88d6106f1f98dae07ad1d4d9">FAILED</a> = 1, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fa9b5fcb2a5e8d51a2e0b226db719afdce">TOO_LAZY</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fa98785bbda1dd780a55df61e01dbc079c">NOT_IMPLEMENTED</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fa0abe90bc3a8084a68a952e2cc9a12261">STATE_CHANGE</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640faab8b9b807fb3248e28d8256064c5e5b4">PAD</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fa33a9051bfee463dad41f593bd10ef44e">THREAD</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fafeddcfe31b565fa8c0fea0a93cb5fc8d">NEGOTIATION</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fac5cf28e3152d440024ca9a3d07198a6c">EVENT</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fa2c2a50a2bb5eb706052fdd29e66b15d7">SEEK</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fae48405bd45616033760cb813bd511281">CAPS</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640faf8d4409f95a9a331a8c5340736895213">TAG</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fa2707f18f1bdb6370892ac846aefb163f">MISSING_PLUGIN</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fabf4983a0910e1652ed111eb697a3f9dc">CLOCK</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fa7c1a3abca04dfc6c1d25da77a5f1db4f">DISABLED</a>, <br/>
  <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640fae62f4a016d65ab781fa3aca456c0abf1">NUM_ERRORS</a>
<br/>
}</td></tr>
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGst_1_1CoreError.html#ad0a98e15ca3ec5e530715c0c3a8c461a">CoreError</a> (<a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640f">Code</a> error_code, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& error_message)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGst_1_1CoreError.html#a0bc9e73db323cf8022ce4a814a421d4a">CoreError</a> (GError* gobject)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640f">Code</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGst_1_1CoreError.html#a2b4896ef30998cdc5a36f4d469d5df40">code</a> () const </td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>The GStreamer core GError type. </p>
<p>GStreamer elements can throw non-fatal warnings and fatal errors. Higher-level elements and applications can programatically filter the ones they are interested in or can recover from, and have a default handler handle the rest of them. Both warnings and fatal errors are treated similarly.</p>
<p>Core errors are errors inside the core GStreamer library:</p>
<ul>
<li>FAILED - a general error which doesn't fit in any other category. Make sure you add a custom message to the error call.</li>
<li>TOO_LAZY - do not use this except as a placeholder for deciding where to go while developing code.</li>
<li>NOT_IMPLEMENTED - use this when you do not want to implement this functionality yet.</li>
<li>STATE_CHANGE - used for state change errors.</li>
<li>PAD - used for pad-related errors.</li>
<li>THREAD - used for thread-related errors.</li>
<li>NEGOTIATION - used for negotiation-related errors.</li>
<li>EVENT - used for event-related errors.</li>
<li>SEEK - used for seek-related errors.</li>
<li>CAPS - used for caps-related errors.</li>
<li>TAG - used for negotiation-related errors.</li>
<li>MISSING_PLUGIN - used if a plugin is missing.</li>
<li>CLOCK - used for clock related errors.</li>
<li>DISABLED - used if functionality has been disabled at compile time (Since: 0.10.13).</li>
<li>NUM_ERRORS - the number of core error types.</li>
</ul>
<p>Elements do not have the context required to decide what to do with errors. As such, they should only inform about errors, and stop their processing. In short, an element doesn't know what it is being used for.</p>
<p>It is the application or compound element using the given element that has more context about the use of the element. Errors can be received by listening to the <a class="el" href="classGst_1_1Bus.html" title="Gst::Bus - Asynchronous message bus subsystem.">Gst::Bus</a> of the element/pipeline for <a class="el" href="classGst_1_1Message.html" title="Gst::Message - Lightweight objects to signal the application of pipeline events.">Gst::Message</a> objects with the type <a class="el" href="group__gstreamermmEnums.html#gga704e8de3c3f9698d3c3ca15d61190a86a8cb728e3c03839f9b1d6e68f1949c5dd">Gst::MESSAGE_ERROR</a> or <a class="el" href="group__gstreamermmEnums.html#gga704e8de3c3f9698d3c3ca15d61190a86a5c2fd057499aa561dfbb9e89ffa9b0e2">Gst::MESSAGE_WARNING</a>. The thrown errors should be inspected, and filtered if appropriate.</p>
<p>An application is expected to, by default, present the user with a dialog box (or an equivalent) showing the error message. The dialog should also allow a way to get at the additional debug information, so the user can provide bug reporting information.</p>
<p>A compound element is expected to forward errors by default higher up the hierarchy; this is done by default in the same way as for other types of <a class="el" href="classGst_1_1Message.html" title="Gst::Message - Lightweight objects to signal the application of pipeline events.">Gst::Message</a>.</p>
<p>When applications or compound elements trigger errors that they can recover from, they can filter out these errors and take appropriate action. For example, an application that gets an error from xvimagesink that indicates all XVideo ports are taken, the application can attempt to use another sink instead. </p>
<hr/><h2>Member Enumeration Documentation</h2>
<a class="anchor" id="abfd91ec42c060fbc76c30f820eee640f"></a><!-- doxytag: member="Gst::CoreError::Code" ref="abfd91ec42c060fbc76c30f820eee640f" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640f">Gst::CoreError::Code</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640faca4338de88d6106f1f98dae07ad1d4d9"></a><!-- doxytag: member="FAILED" ref="abfd91ec42c060fbc76c30f820eee640faca4338de88d6106f1f98dae07ad1d4d9" args="" -->FAILED</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fa9b5fcb2a5e8d51a2e0b226db719afdce"></a><!-- doxytag: member="TOO_LAZY" ref="abfd91ec42c060fbc76c30f820eee640fa9b5fcb2a5e8d51a2e0b226db719afdce" args="" -->TOO_LAZY</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fa98785bbda1dd780a55df61e01dbc079c"></a><!-- doxytag: member="NOT_IMPLEMENTED" ref="abfd91ec42c060fbc76c30f820eee640fa98785bbda1dd780a55df61e01dbc079c" args="" -->NOT_IMPLEMENTED</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fa0abe90bc3a8084a68a952e2cc9a12261"></a><!-- doxytag: member="STATE_CHANGE" ref="abfd91ec42c060fbc76c30f820eee640fa0abe90bc3a8084a68a952e2cc9a12261" args="" -->STATE_CHANGE</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640faab8b9b807fb3248e28d8256064c5e5b4"></a><!-- doxytag: member="PAD" ref="abfd91ec42c060fbc76c30f820eee640faab8b9b807fb3248e28d8256064c5e5b4" args="" -->PAD</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fa33a9051bfee463dad41f593bd10ef44e"></a><!-- doxytag: member="THREAD" ref="abfd91ec42c060fbc76c30f820eee640fa33a9051bfee463dad41f593bd10ef44e" args="" -->THREAD</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fafeddcfe31b565fa8c0fea0a93cb5fc8d"></a><!-- doxytag: member="NEGOTIATION" ref="abfd91ec42c060fbc76c30f820eee640fafeddcfe31b565fa8c0fea0a93cb5fc8d" args="" -->NEGOTIATION</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fac5cf28e3152d440024ca9a3d07198a6c"></a><!-- doxytag: member="EVENT" ref="abfd91ec42c060fbc76c30f820eee640fac5cf28e3152d440024ca9a3d07198a6c" args="" -->EVENT</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fa2c2a50a2bb5eb706052fdd29e66b15d7"></a><!-- doxytag: member="SEEK" ref="abfd91ec42c060fbc76c30f820eee640fa2c2a50a2bb5eb706052fdd29e66b15d7" args="" -->SEEK</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fae48405bd45616033760cb813bd511281"></a><!-- doxytag: member="CAPS" ref="abfd91ec42c060fbc76c30f820eee640fae48405bd45616033760cb813bd511281" args="" -->CAPS</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640faf8d4409f95a9a331a8c5340736895213"></a><!-- doxytag: member="TAG" ref="abfd91ec42c060fbc76c30f820eee640faf8d4409f95a9a331a8c5340736895213" args="" -->TAG</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fa2707f18f1bdb6370892ac846aefb163f"></a><!-- doxytag: member="MISSING_PLUGIN" ref="abfd91ec42c060fbc76c30f820eee640fa2707f18f1bdb6370892ac846aefb163f" args="" -->MISSING_PLUGIN</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fabf4983a0910e1652ed111eb697a3f9dc"></a><!-- doxytag: member="CLOCK" ref="abfd91ec42c060fbc76c30f820eee640fabf4983a0910e1652ed111eb697a3f9dc" args="" -->CLOCK</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fa7c1a3abca04dfc6c1d25da77a5f1db4f"></a><!-- doxytag: member="DISABLED" ref="abfd91ec42c060fbc76c30f820eee640fa7c1a3abca04dfc6c1d25da77a5f1db4f" args="" -->DISABLED</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="abfd91ec42c060fbc76c30f820eee640fae62f4a016d65ab781fa3aca456c0abf1"></a><!-- doxytag: member="NUM_ERRORS" ref="abfd91ec42c060fbc76c30f820eee640fae62f4a016d65ab781fa3aca456c0abf1" args="" -->NUM_ERRORS</em> </td><td>
</td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="ad0a98e15ca3ec5e530715c0c3a8c461a"></a><!-- doxytag: member="Gst::CoreError::CoreError" ref="ad0a98e15ca3ec5e530715c0c3a8c461a" args="(Code error_code, const Glib::ustring &error_message)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gst::CoreError::CoreError </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640f">Code</a> </td>
<td class="paramname"> <em>error_code</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>error_message</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a0bc9e73db323cf8022ce4a814a421d4a"></a><!-- doxytag: member="Gst::CoreError::CoreError" ref="a0bc9e73db323cf8022ce4a814a421d4a" args="(GError *gobject)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gst::CoreError::CoreError </td>
<td>(</td>
<td class="paramtype">GError * </td>
<td class="paramname"> <em>gobject</em></td>
<td> ) </td>
<td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a2b4896ef30998cdc5a36f4d469d5df40"></a><!-- doxytag: member="Gst::CoreError::code" ref="a2b4896ef30998cdc5a36f4d469d5df40" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGst_1_1CoreError.html#abfd91ec42c060fbc76c30f820eee640f">Code</a> Gst::CoreError::code </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1Error.html#a073623423095dc52db289bf04a146648">Glib::Error</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>gstreamermm/error.h</li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Mon Sep 21 22:32:55 2009 for gstreamermm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
7a65d2578765429f23843d9c8d1c0efa
>
files
>
370
