<!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>gstreamermm: Gst::ResourceError Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="doxygen-extra.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">gstreamermm
 <span id="projectnumber">1.10.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',false,false,'search.php','Search');
});
</script>
<div id="main-nav"></div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceGst.html">Gst</a></li><li class="navelem"><a class="el" href="classGst_1_1ResourceError.html">ResourceError</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-types">Public Types</a> |
<a href="#pub-methods">Public Member Functions</a> |
<a href="classGst_1_1ResourceError-members.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">Gst::ResourceError Class Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>The GStreamer resource GError type.
<a href="classGst_1_1ResourceError.html#details">More...</a></p>
<p><code>#include <gstreamermm/error.h></code></p>
<p>Inherits Error.</p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr class="memitem:a90234857351dc8724ff4daa53426719b"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719b">Code</a> { <br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719baf14be622017655e273f1e32c348fc20e">FAILED</a> = 1,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719ba129ae47035d37a211485052febb4205a">TOO_LAZY</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719ba3c8e9a3ec9b6512921c3aff8219da77b">NOT_FOUND</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719bab0eefc887f62f09f925cc185e238aa7e">BUSY</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719baa84ad738ac7c0c40ed8877f30201f615">OPEN_READ</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719baf8e594af0b7334830bc77c26974ceacd">OPEN_WRITE</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719ba6da673a698e03895bd0e5ab798024ebe">OPEN_READ_WRITE</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719baa219526faaa36a0a89709eb1fd91dc73">CLOSE</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719ba0c30a33b52e93c15cef6438a922af9f2">READ</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719bafc0dfef45e3b516f7deb83701a994dc7">WRITE</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719bad73c12885c0bd6e58a5b8d05277f0065">SEEK</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719bae8eb90ee41e0cafa6bae59c486fbb027">SYNC</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719baeba91807e2b82c25384d4cc7196ee27c">SETTINGS</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719baf94b19406d1e2e6aa445b50bed314693">NO_SPACE_LEFT</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719ba5d87bfddd254b3dcf29779d8e9eb301e">NOT_AUTHORIZED</a>,
<br />
  <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719baa11ff906cb13665442739bf214c8efa0">NUM_ERRORS</a>
<br />
}<tr class="memdesc:a90234857351dc8724ff4daa53426719b"><td class="mdescLeft"> </td><td class="mdescRight">Resource errors are for any resource used by an element: memory, files, network connections, process space, ... <a href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719b">More...</a><br /></td></tr>
</td></tr>
<tr class="separator:a90234857351dc8724ff4daa53426719b"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:afcf5e62ab64c0d2b19cdd9256196e3f0"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGst_1_1ResourceError.html#afcf5e62ab64c0d2b19cdd9256196e3f0">ResourceError</a> (<a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719b">Code</a> error_code, const Glib::ustring& error_message)</td></tr>
<tr class="separator:afcf5e62ab64c0d2b19cdd9256196e3f0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa5ff0f801d023ee88abff111ac4ff7dc"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGst_1_1ResourceError.html#aa5ff0f801d023ee88abff111ac4ff7dc">ResourceError</a> (GError* gobject)</td></tr>
<tr class="separator:aa5ff0f801d023ee88abff111ac4ff7dc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2691b2ae2d58562faa9ff4f8c3a87481"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719b">Code</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGst_1_1ResourceError.html#a2691b2ae2d58562faa9ff4f8c3a87481">code</a> () const</td></tr>
<tr class="separator:a2691b2ae2d58562faa9ff4f8c3a87481"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>The GStreamer resource 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>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.</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_FOUND - used when the resource could not be found.</li>
<li>BUSY - used when resource is busy.</li>
<li>OPEN_READ - used when resource fails to open for reading.</li>
<li>OPEN_WRITE - used when resource fails to open for writing.</li>
<li>OPEN_READ_WRITE - used when resource cannot be opened for both reading and writing, or either (but unspecified which).</li>
<li>CLOSE - used when the resource can't be closed.</li>
<li>READ - used when the resource can't be read from.</li>
<li>WRITE - used when the resource can't be written to.</li>
<li>SEEK - used when a seek on the resource fails.</li>
<li>SYNC - used when a synchronize on the resource fails.</li>
<li>SETTINGS - used when settings can't be manipulated on.</li>
<li>NO_SPACE_LEFT - used when the resource has no space left.</li>
<li>NUM_ERRORS - the number of resource 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="A class that encompasses the GStreamer asynchronous message bus subsystem. ">Gst::Bus</a> of the element/pipeline for <a class="el" href="classGst_1_1Message.html" title="A class that represents lightweight objects to signal the application of pipeline events...">Gst::Message</a> objects with the type <a class="el" href="namespaceGst.html#ga704e8de3c3f9698d3c3ca15d61190a86a758493cee50de74b68fa2fe29ba4bad9" title="An error occurred. ">Gst::MESSAGE_ERROR</a> or <a class="el" href="namespaceGst.html#ga704e8de3c3f9698d3c3ca15d61190a86a10897339e9a539206a3063366a001fe7" title="A warning occurred. ">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="A class that represents 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>
</div><h2 class="groupheader">Member Enumeration Documentation</h2>
<a id="a90234857351dc8724ff4daa53426719b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a90234857351dc8724ff4daa53426719b">◆ </a></span>Code</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719b">Gst::ResourceError::Code</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>Resource errors are for any resource used by an element: memory, files, network connections, process space, ... </p>
<p>They're typically used by source and sink elements. </p>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719baf14be622017655e273f1e32c348fc20e"></a>FAILED </td><td class="fielddoc"><p>A general error which doesn't fit in any other category. </p>
<p>Make sure you add a custom message to the error call. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719ba129ae47035d37a211485052febb4205a"></a>TOO_LAZY </td><td class="fielddoc"><p>Do not use this except as a placeholder for deciding where to go while developing code. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719ba3c8e9a3ec9b6512921c3aff8219da77b"></a>NOT_FOUND </td><td class="fielddoc"><p>Used when the resource could not be found. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719bab0eefc887f62f09f925cc185e238aa7e"></a>BUSY </td><td class="fielddoc"><p>Used when resource is busy. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719baa84ad738ac7c0c40ed8877f30201f615"></a>OPEN_READ </td><td class="fielddoc"><p>Used when resource fails to open for reading. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719baf8e594af0b7334830bc77c26974ceacd"></a>OPEN_WRITE </td><td class="fielddoc"><p>Used when resource fails to open for writing. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719ba6da673a698e03895bd0e5ab798024ebe"></a>OPEN_READ_WRITE </td><td class="fielddoc"><p>Used when resource cannot be opened for both reading and writing, or either (but unspecified which). </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719baa219526faaa36a0a89709eb1fd91dc73"></a>CLOSE </td><td class="fielddoc"><p>Used when the resource can't be closed. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719ba0c30a33b52e93c15cef6438a922af9f2"></a>READ </td><td class="fielddoc"><p>Used when the resource can't be read from. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719bafc0dfef45e3b516f7deb83701a994dc7"></a>WRITE </td><td class="fielddoc"><p>Used when the resource can't be written to. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719bad73c12885c0bd6e58a5b8d05277f0065"></a>SEEK </td><td class="fielddoc"><p>Used when a seek on the resource fails. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719bae8eb90ee41e0cafa6bae59c486fbb027"></a>SYNC </td><td class="fielddoc"><p>Used when a synchronize on the resource fails. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719baeba91807e2b82c25384d4cc7196ee27c"></a>SETTINGS </td><td class="fielddoc"><p>Used when settings can't be manipulated on. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719baf94b19406d1e2e6aa445b50bed314693"></a>NO_SPACE_LEFT </td><td class="fielddoc"><p>Used when the resource has no space left. </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719ba5d87bfddd254b3dcf29779d8e9eb301e"></a>NOT_AUTHORIZED </td><td class="fielddoc"><p>Used when the resource can't be opened due to missing authorization. </p>
<p>(Since 1.2.4). </p>
</td></tr>
<tr><td class="fieldname"><a id="a90234857351dc8724ff4daa53426719baa11ff906cb13665442739bf214c8efa0"></a>NUM_ERRORS </td><td class="fielddoc"><p>The number of resource error types. </p>
</td></tr>
</table>
</div>
</div>
<h2 class="groupheader">Constructor & Destructor Documentation</h2>
<a id="afcf5e62ab64c0d2b19cdd9256196e3f0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#afcf5e62ab64c0d2b19cdd9256196e3f0">◆ </a></span>ResourceError() <span class="overload">[1/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gst::ResourceError::ResourceError </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719b">Code</a> </td>
<td class="paramname"><em>error_code</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const Glib::ustring & </td>
<td class="paramname"><em>error_message</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
</div>
</div>
<a id="aa5ff0f801d023ee88abff111ac4ff7dc"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa5ff0f801d023ee88abff111ac4ff7dc">◆ </a></span>ResourceError() <span class="overload">[2/2]</span></h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">Gst::ResourceError::ResourceError </td>
<td>(</td>
<td class="paramtype">GError * </td>
<td class="paramname"><em>gobject</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">explicit</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a id="a2691b2ae2d58562faa9ff4f8c3a87481"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2691b2ae2d58562faa9ff4f8c3a87481">◆ </a></span>code()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGst_1_1ResourceError.html#a90234857351dc8724ff4daa53426719b">Code</a> Gst::ResourceError::code </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Sat Oct 21 2017 12:59:01 for gstreamermm by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.13
</small></address>
</body>
</html>
