1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GUPnPRootDevice</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7 <link rel="home" href="index.html" title="GUPnP Reference Manual">
8 <link rel="up" href="api-device-impl.html" title="Device Implementation">
9 <link rel="prev" href="GUPnPDevice.html" title="GUPnPDevice">
10 <link rel="next" href="GUPnPService.html" title="GUPnPService">
11 <meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="GUPnPDevice.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="api-device-impl.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GUPnP Reference Manual</th>
21 <td><a accesskey="n" href="GUPnPService.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GUPnPRootDevice.synopsis" class="shortcut">Top</a>
26 <a href="#GUPnPRootDevice.description" class="shortcut">Description</a>
28 <a href="#GUPnPRootDevice.object-hierarchy" class="shortcut">Object Hierarchy</a>
30 <a href="#GUPnPRootDevice.properties" class="shortcut">Properties</a>
33 <div class="refentry">
34 <a name="GUPnPRootDevice"></a><div class="titlepage"></div>
35 <div class="refnamediv"><table width="100%"><tr>
37 <h2><span class="refentrytitle"><a name="GUPnPRootDevice.top_of_page"></a>GUPnPRootDevice</span></h2>
38 <p>GUPnPRootDevice — Class for root device implementations.</p>
40 <td valign="top" align="right"></td>
42 <div class="refsynopsisdiv">
43 <a name="GUPnPRootDevice.synopsis"></a><h2>Synopsis</h2>
44 <pre class="synopsis"> <a class="link" href="GUPnPRootDevice.html#GUPnPRootDevice-struct" title="GUPnPRootDevice">GUPnPRootDevice</a>;
45 <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="returnvalue">GUPnPRootDevice</span></a> * <a class="link" href="GUPnPRootDevice.html#gupnp-root-device-new" title="gupnp_root_device_new ()">gupnp_root_device_new</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
46 <em class="parameter"><code>const <span class="type">char</span> *description_path</code></em>,
47 <em class="parameter"><code>const <span class="type">char</span> *description_dir</code></em>);
48 <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="returnvalue">GUPnPRootDevice</span></a> * <a class="link" href="GUPnPRootDevice.html#gupnp-root-device-new-full" title="gupnp_root_device_new_full ()">gupnp_root_device_new_full</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
49 <em class="parameter"><code><a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a> *factory</code></em>,
50 <em class="parameter"><code><a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a> *description_doc</code></em>,
51 <em class="parameter"><code>const <span class="type">char</span> *description_path</code></em>,
52 <em class="parameter"><code>const <span class="type">char</span> *description_dir</code></em>);
53 <span class="returnvalue">void</span> <a class="link" href="GUPnPRootDevice.html#gupnp-root-device-set-available" title="gupnp_root_device_set_available ()">gupnp_root_device_set_available</a> (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>,
54 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> available</code></em>);
55 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GUPnPRootDevice.html#gupnp-root-device-get-available" title="gupnp_root_device_get_available ()">gupnp_root_device_get_available</a> (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);
56 const <span class="returnvalue">char</span> * <a class="link" href="GUPnPRootDevice.html#gupnp-root-device-get-relative-location" title="gupnp_root_device_get_relative_location ()">gupnp_root_device_get_relative_location</a>
57 (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);
58 const <span class="returnvalue">char</span> * <a class="link" href="GUPnPRootDevice.html#gupnp-root-device-get-description-dir" title="gupnp_root_device_get_description_dir ()">gupnp_root_device_get_description_dir</a>
59 (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);
60 const <span class="returnvalue">char</span> * <a class="link" href="GUPnPRootDevice.html#gupnp-root-device-get-description-path" title="gupnp_root_device_get_description_path ()">gupnp_root_device_get_description_path</a>
61 (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);
64 <div class="refsect1">
65 <a name="GUPnPRootDevice.object-hierarchy"></a><h2>Object Hierarchy</h2>
66 <pre class="synopsis">
67 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
68 +----<a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo">GUPnPDeviceInfo</a>
69 +----<a class="link" href="GUPnPDevice.html" title="GUPnPDevice">GUPnPDevice</a>
73 <div class="refsect1">
74 <a name="GUPnPRootDevice.properties"></a><h2>Properties</h2>
75 <pre class="synopsis">
76 "<a class="link" href="GUPnPRootDevice.html#GUPnPRootDevice--available" title='The "available" property'>available</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write
77 "<a class="link" href="GUPnPRootDevice.html#GUPnPRootDevice--description-dir" title='The "description-dir" property'>description-dir</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only
78 "<a class="link" href="GUPnPRootDevice.html#GUPnPRootDevice--description-doc" title='The "description-doc" property'>description-doc</a>" <a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a>* : Write / Construct Only
79 "<a class="link" href="GUPnPRootDevice.html#GUPnPRootDevice--description-path" title='The "description-path" property'>description-path</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only
82 <div class="refsect1">
83 <a name="GUPnPRootDevice.description"></a><h2>Description</h2>
85 <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> allows for implementing root devices.
90 <div class="refsect1">
91 <a name="GUPnPRootDevice.details"></a><h2>Details</h2>
92 <div class="refsect2">
93 <a name="GUPnPRootDevice-struct"></a><h3>GUPnPRootDevice</h3>
94 <pre class="programlisting">typedef struct _GUPnPRootDevice GUPnPRootDevice;</pre>
96 This struct contains private data only, and should be accessed using the
103 <div class="refsect2">
104 <a name="gupnp-root-device-new"></a><h3>gupnp_root_device_new ()</h3>
105 <pre class="programlisting"><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="returnvalue">GUPnPRootDevice</span></a> * gupnp_root_device_new (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
106 <em class="parameter"><code>const <span class="type">char</span> *description_path</code></em>,
107 <em class="parameter"><code>const <span class="type">char</span> *description_dir</code></em>);</pre>
109 Create a new <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> object, automatically loading and parsing
110 device description document from <em class="parameter"><code>description_path</code></em>.
114 <div class="variablelist"><table border="0">
115 <col align="left" valign="top">
118 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
119 <td>The <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
123 <td><p><span class="term"><em class="parameter"><code>description_path</code></em> :</span></p></td>
124 <td>Path to device description document. This could either
125 be an absolute path or path relative to <em class="parameter"><code>description_dir</code></em>.
129 <td><p><span class="term"><em class="parameter"><code>description_dir</code></em> :</span></p></td>
130 <td>Path to directory where description documents are provided.
134 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
135 <td> A new <em class="parameter"><code>GUPnPRootDevice</code></em> object.
142 <div class="refsect2">
143 <a name="gupnp-root-device-new-full"></a><h3>gupnp_root_device_new_full ()</h3>
144 <pre class="programlisting"><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="returnvalue">GUPnPRootDevice</span></a> * gupnp_root_device_new_full (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
145 <em class="parameter"><code><a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a> *factory</code></em>,
146 <em class="parameter"><code><a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a> *description_doc</code></em>,
147 <em class="parameter"><code>const <span class="type">char</span> *description_path</code></em>,
148 <em class="parameter"><code>const <span class="type">char</span> *description_dir</code></em>);</pre>
150 Create a new <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a>, automatically loading and parsing
151 device description document from <em class="parameter"><code>description_path</code></em> if <em class="parameter"><code>description_doc</code></em> is
152 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
156 <div class="variablelist"><table border="0">
157 <col align="left" valign="top">
160 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
161 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
165 <td><p><span class="term"><em class="parameter"><code>factory</code></em> :</span></p></td>
166 <td>A <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a>
170 <td><p><span class="term"><em class="parameter"><code>description_doc</code></em> :</span></p></td>
171 <td>Device description document, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
175 <td><p><span class="term"><em class="parameter"><code>description_path</code></em> :</span></p></td>
176 <td>Path to device description document. This could either
177 be an absolute path or path relative to <em class="parameter"><code>description_dir</code></em>.
181 <td><p><span class="term"><em class="parameter"><code>description_dir</code></em> :</span></p></td>
182 <td>Path to directory where description documents are provided.
186 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
187 <td> A new <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> object.
194 <div class="refsect2">
195 <a name="gupnp-root-device-set-available"></a><h3>gupnp_root_device_set_available ()</h3>
196 <pre class="programlisting"><span class="returnvalue">void</span> gupnp_root_device_set_available (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>,
197 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> available</code></em>);</pre>
199 Controls whether or not <em class="parameter"><code>root_device</code></em> is available (announcing
204 <div class="variablelist"><table border="0">
205 <col align="left" valign="top">
208 <td><p><span class="term"><em class="parameter"><code>root_device</code></em> :</span></p></td>
209 <td>A <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a>
213 <td><p><span class="term"><em class="parameter"><code>available</code></em> :</span></p></td>
215 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>root_device</code></em> should be available
222 <div class="refsect2">
223 <a name="gupnp-root-device-get-available"></a><h3>gupnp_root_device_get_available ()</h3>
224 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gupnp_root_device_get_available (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);</pre>
226 Get whether or not <em class="parameter"><code>root_device</code></em> is available (announcing its presence).
230 <div class="variablelist"><table border="0">
231 <col align="left" valign="top">
234 <td><p><span class="term"><em class="parameter"><code>root_device</code></em> :</span></p></td>
235 <td>A <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a>
239 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
240 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>root_device</code></em> is available, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
247 <div class="refsect2">
248 <a name="gupnp-root-device-get-relative-location"></a><h3>gupnp_root_device_get_relative_location ()</h3>
249 <pre class="programlisting">const <span class="returnvalue">char</span> * gupnp_root_device_get_relative_location
250 (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);</pre>
252 Get the relative location of <em class="parameter"><code>root_device</code></em>.
256 <div class="variablelist"><table border="0">
257 <col align="left" valign="top">
260 <td><p><span class="term"><em class="parameter"><code>root_device</code></em> :</span></p></td>
261 <td>A <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a>
265 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
266 <td> The relative location of <em class="parameter"><code>root_device</code></em>.
273 <div class="refsect2">
274 <a name="gupnp-root-device-get-description-dir"></a><h3>gupnp_root_device_get_description_dir ()</h3>
275 <pre class="programlisting">const <span class="returnvalue">char</span> * gupnp_root_device_get_description_dir
276 (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);</pre>
278 Get the path to the directory containing description documents related to
279 <em class="parameter"><code>root_device</code></em>.
283 <div class="variablelist"><table border="0">
284 <col align="left" valign="top">
287 <td><p><span class="term"><em class="parameter"><code>root_device</code></em> :</span></p></td>
288 <td>A <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a>
292 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
293 <td> The path to description document directory of <em class="parameter"><code>root_device</code></em>.
300 <div class="refsect2">
301 <a name="gupnp-root-device-get-description-path"></a><h3>gupnp_root_device_get_description_path ()</h3>
302 <pre class="programlisting">const <span class="returnvalue">char</span> * gupnp_root_device_get_description_path
303 (<em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);</pre>
305 Get the path to the device description document of <em class="parameter"><code>root_device</code></em>.
309 <div class="variablelist"><table border="0">
310 <col align="left" valign="top">
313 <td><p><span class="term"><em class="parameter"><code>root_device</code></em> :</span></p></td>
314 <td>A <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a>
318 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
319 <td> The path to device description document of <em class="parameter"><code>root_device</code></em>.
326 <div class="refsect1">
327 <a name="GUPnPRootDevice.property-details"></a><h2>Property Details</h2>
328 <div class="refsect2">
329 <a name="GUPnPRootDevice--available"></a><h3>The <code class="literal">"available"</code> property</h3>
330 <pre class="programlisting"> "available" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
332 TRUE if this device is available.
336 <p>Default value: FALSE</p>
339 <div class="refsect2">
340 <a name="GUPnPRootDevice--description-dir"></a><h3>The <code class="literal">"description-dir"</code> property</h3>
341 <pre class="programlisting"> "description-dir" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only</pre>
343 The path to directory where description documents are provided.
347 <p>Default value: NULL</p>
350 <div class="refsect2">
351 <a name="GUPnPRootDevice--description-doc"></a><h3>The <code class="literal">"description-doc"</code> property</h3>
352 <pre class="programlisting"> "description-doc" <a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a>* : Write / Construct Only</pre>
354 Device description document. Constructor property.
360 <div class="refsect2">
361 <a name="GUPnPRootDevice--description-path"></a><h3>The <code class="literal">"description-path"</code> property</h3>
362 <pre class="programlisting"> "description-path" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only</pre>
364 The path to device description document. This could either be an
365 absolute path or path relative to GUPnPRootDevice:description-dir.
369 <p>Default value: NULL</p>
375 Generated by GTK-Doc V1.15.1</div>