Imported Upstream version 0.20.12
[profile/ivi/GUPnP.git] / doc / html / GUPnPDeviceInfo.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GUPnP Reference Manual: GUPnPDeviceInfo</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7 <link rel="home" href="index.html" title="GUPnP Reference Manual">
8 <link rel="up" href="api-device-info.html" title="Device Information">
9 <link rel="prev" href="api-device-info.html" title="Device Information">
10 <link rel="next" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo">
11 <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
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="10"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts">
17 <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18                   <a href="#GUPnPDeviceInfo.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19                   <a href="#GUPnPDeviceInfo.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> 
20                   <a href="#GUPnPDeviceInfo.properties" class="shortcut">Properties</a></span>
21 </td>
22 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
23 <td><a accesskey="u" href="api-device-info.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
24 <td><a accesskey="p" href="api-device-info.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
25 <td><a accesskey="n" href="GUPnPServiceInfo.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
26 </tr></table>
27 <div class="refentry">
28 <a name="GUPnPDeviceInfo"></a><div class="titlepage"></div>
29 <div class="refnamediv"><table width="100%"><tr>
30 <td valign="top">
31 <h2><span class="refentrytitle"><a name="GUPnPDeviceInfo.top_of_page"></a>GUPnPDeviceInfo</span></h2>
32 <p>GUPnPDeviceInfo — Base abstract class for querying device information.</p>
33 </td>
34 <td class="gallery_image" valign="top" align="right"></td>
35 </tr></table></div>
36 <div class="refsect1">
37 <a name="GUPnPDeviceInfo.functions"></a><h2>Functions</h2>
38 <div class="informaltable"><table width="100%" border="0">
39 <colgroup>
40 <col width="150px" class="functions_return">
41 <col class="functions_name">
42 </colgroup>
43 <tbody>
44 <tr>
45 <td class="function_type">
46 <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="returnvalue">GUPnPResourceFactory</span></a> *
47 </td>
48 <td class="function_name">
49 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-resource-factory" title="gupnp_device_info_get_resource_factory ()">gupnp_device_info_get_resource_factory</a> <span class="c_punctuation">()</span>
50 </td>
51 </tr>
52 <tr>
53 <td class="function_type">
54 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="returnvalue">GUPnPContext</span></a> *
55 </td>
56 <td class="function_name">
57 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-context" title="gupnp_device_info_get_context ()">gupnp_device_info_get_context</a> <span class="c_punctuation">()</span>
58 </td>
59 </tr>
60 <tr>
61 <td class="function_type">const <span class="returnvalue">char</span> *
62 </td>
63 <td class="function_name">
64 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-location" title="gupnp_device_info_get_location ()">gupnp_device_info_get_location</a> <span class="c_punctuation">()</span>
65 </td>
66 </tr>
67 <tr>
68 <td class="function_type">const <a href="/usr/share/gtk-doc/html/libsoup-2.4/SoupURI.html"><span class="returnvalue">SoupURI</span></a> *
69 </td>
70 <td class="function_name">
71 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-url-base" title="gupnp_device_info_get_url_base ()">gupnp_device_info_get_url_base</a> <span class="c_punctuation">()</span>
72 </td>
73 </tr>
74 <tr>
75 <td class="function_type">const <span class="returnvalue">char</span> *
76 </td>
77 <td class="function_name">
78 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-udn" title="gupnp_device_info_get_udn ()">gupnp_device_info_get_udn</a> <span class="c_punctuation">()</span>
79 </td>
80 </tr>
81 <tr>
82 <td class="function_type">const <span class="returnvalue">char</span> *
83 </td>
84 <td class="function_name">
85 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-device-type" title="gupnp_device_info_get_device_type ()">gupnp_device_info_get_device_type</a> <span class="c_punctuation">()</span>
86 </td>
87 </tr>
88 <tr>
89 <td class="function_type">
90 <span class="returnvalue">char</span> *
91 </td>
92 <td class="function_name">
93 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-friendly-name" title="gupnp_device_info_get_friendly_name ()">gupnp_device_info_get_friendly_name</a> <span class="c_punctuation">()</span>
94 </td>
95 </tr>
96 <tr>
97 <td class="function_type">
98 <span class="returnvalue">char</span> *
99 </td>
100 <td class="function_name">
101 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-manufacturer" title="gupnp_device_info_get_manufacturer ()">gupnp_device_info_get_manufacturer</a> <span class="c_punctuation">()</span>
102 </td>
103 </tr>
104 <tr>
105 <td class="function_type">
106 <span class="returnvalue">char</span> *
107 </td>
108 <td class="function_name">
109 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-manufacturer-url" title="gupnp_device_info_get_manufacturer_url ()">gupnp_device_info_get_manufacturer_url</a> <span class="c_punctuation">()</span>
110 </td>
111 </tr>
112 <tr>
113 <td class="function_type">
114 <span class="returnvalue">char</span> *
115 </td>
116 <td class="function_name">
117 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-model-description" title="gupnp_device_info_get_model_description ()">gupnp_device_info_get_model_description</a> <span class="c_punctuation">()</span>
118 </td>
119 </tr>
120 <tr>
121 <td class="function_type">
122 <span class="returnvalue">char</span> *
123 </td>
124 <td class="function_name">
125 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-model-name" title="gupnp_device_info_get_model_name ()">gupnp_device_info_get_model_name</a> <span class="c_punctuation">()</span>
126 </td>
127 </tr>
128 <tr>
129 <td class="function_type">
130 <span class="returnvalue">char</span> *
131 </td>
132 <td class="function_name">
133 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-model-number" title="gupnp_device_info_get_model_number ()">gupnp_device_info_get_model_number</a> <span class="c_punctuation">()</span>
134 </td>
135 </tr>
136 <tr>
137 <td class="function_type">
138 <span class="returnvalue">char</span> *
139 </td>
140 <td class="function_name">
141 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-model-url" title="gupnp_device_info_get_model_url ()">gupnp_device_info_get_model_url</a> <span class="c_punctuation">()</span>
142 </td>
143 </tr>
144 <tr>
145 <td class="function_type">
146 <span class="returnvalue">char</span> *
147 </td>
148 <td class="function_name">
149 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-serial-number" title="gupnp_device_info_get_serial_number ()">gupnp_device_info_get_serial_number</a> <span class="c_punctuation">()</span>
150 </td>
151 </tr>
152 <tr>
153 <td class="function_type">
154 <span class="returnvalue">char</span> *
155 </td>
156 <td class="function_name">
157 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-presentation-url" title="gupnp_device_info_get_presentation_url ()">gupnp_device_info_get_presentation_url</a> <span class="c_punctuation">()</span>
158 </td>
159 </tr>
160 <tr>
161 <td class="function_type">
162 <span class="returnvalue">char</span> *
163 </td>
164 <td class="function_name">
165 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-upc" title="gupnp_device_info_get_upc ()">gupnp_device_info_get_upc</a> <span class="c_punctuation">()</span>
166 </td>
167 </tr>
168 <tr>
169 <td class="function_type">
170 <span class="returnvalue">char</span> *
171 </td>
172 <td class="function_name">
173 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-icon-url" title="gupnp_device_info_get_icon_url ()">gupnp_device_info_get_icon_url</a> <span class="c_punctuation">()</span>
174 </td>
175 </tr>
176 <tr>
177 <td class="function_type">
178 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
179 </td>
180 <td class="function_name">
181 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-list-dlna-capabilities" title="gupnp_device_info_list_dlna_capabilities ()">gupnp_device_info_list_dlna_capabilities</a> <span class="c_punctuation">()</span>
182 </td>
183 </tr>
184 <tr>
185 <td class="function_type">
186 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
187 </td>
188 <td class="function_name">
189 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-list-dlna-device-class-identifier" title="gupnp_device_info_list_dlna_device_class_identifier ()">gupnp_device_info_list_dlna_device_class_identifier</a> <span class="c_punctuation">()</span>
190 </td>
191 </tr>
192 <tr>
193 <td class="function_type">
194 <span class="returnvalue">char</span> *
195 </td>
196 <td class="function_name">
197 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-description-value" title="gupnp_device_info_get_description_value ()">gupnp_device_info_get_description_value</a> <span class="c_punctuation">()</span>
198 </td>
199 </tr>
200 <tr>
201 <td class="function_type">
202 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
203 </td>
204 <td class="function_name">
205 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-list-devices" title="gupnp_device_info_list_devices ()">gupnp_device_info_list_devices</a> <span class="c_punctuation">()</span>
206 </td>
207 </tr>
208 <tr>
209 <td class="function_type">
210 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
211 </td>
212 <td class="function_name">
213 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-list-device-types" title="gupnp_device_info_list_device_types ()">gupnp_device_info_list_device_types</a> <span class="c_punctuation">()</span>
214 </td>
215 </tr>
216 <tr>
217 <td class="function_type">
218 <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="returnvalue">GUPnPDeviceInfo</span></a> *
219 </td>
220 <td class="function_name">
221 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-device" title="gupnp_device_info_get_device ()">gupnp_device_info_get_device</a> <span class="c_punctuation">()</span>
222 </td>
223 </tr>
224 <tr>
225 <td class="function_type">
226 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
227 </td>
228 <td class="function_name">
229 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-list-services" title="gupnp_device_info_list_services ()">gupnp_device_info_list_services</a> <span class="c_punctuation">()</span>
230 </td>
231 </tr>
232 <tr>
233 <td class="function_type">
234 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
235 </td>
236 <td class="function_name">
237 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-list-service-types" title="gupnp_device_info_list_service_types ()">gupnp_device_info_list_service_types</a> <span class="c_punctuation">()</span>
238 </td>
239 </tr>
240 <tr>
241 <td class="function_type">
242 <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="returnvalue">GUPnPServiceInfo</span></a> *
243 </td>
244 <td class="function_name">
245 <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-service" title="gupnp_device_info_get_service ()">gupnp_device_info_get_service</a> <span class="c_punctuation">()</span>
246 </td>
247 </tr>
248 </tbody>
249 </table></div>
250 </div>
251 <div class="refsect1">
252 <a name="GUPnPDeviceInfo.properties"></a><h2>Properties</h2>
253 <div class="informaltable"><table border="0">
254 <colgroup>
255 <col width="150px" class="properties_type">
256 <col width="300px" class="properties_name">
257 <col width="200px" class="properties_flags">
258 </colgroup>
259 <tbody>
260 <tr>
261 <td class="property_type">
262 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *</td>
263 <td class="property_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--context" title="The “context” property">context</a></td>
264 <td class="property_flags">Read / Write / Construct Only</td>
265 </tr>
266 <tr>
267 <td class="property_type">
268 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
269 <td class="property_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--device-type" title="The “device-type” property">device-type</a></td>
270 <td class="property_flags">Read / Write / Construct Only</td>
271 </tr>
272 <tr>
273 <td class="property_type">
274 <a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a> *</td>
275 <td class="property_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--document" title="The “document” property">document</a></td>
276 <td class="property_flags">Read / Write / Construct Only</td>
277 </tr>
278 <tr>
279 <td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></td>
280 <td class="property_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--element" title="The “element” property">element</a></td>
281 <td class="property_flags">Write / Construct Only</td>
282 </tr>
283 <tr>
284 <td class="property_type">
285 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
286 <td class="property_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--location" title="The “location” property">location</a></td>
287 <td class="property_flags">Read / Write / Construct Only</td>
288 </tr>
289 <tr>
290 <td class="property_type">
291 <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a> *</td>
292 <td class="property_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--resource-factory" title="The “resource-factory” property">resource-factory</a></td>
293 <td class="property_flags">Read / Write / Construct Only</td>
294 </tr>
295 <tr>
296 <td class="property_type">
297 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
298 <td class="property_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--udn" title="The “udn” property">udn</a></td>
299 <td class="property_flags">Read / Write / Construct Only</td>
300 </tr>
301 <tr>
302 <td class="property_type">
303 <a href="/usr/share/gtk-doc/html/libsoup-2.4/SoupURI.html"><span class="type">SoupURI</span></a> *</td>
304 <td class="property_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--url-base" title="The “url-base” property">url-base</a></td>
305 <td class="property_flags">Read / Write / Construct Only</td>
306 </tr>
307 </tbody>
308 </table></div>
309 </div>
310 <div class="refsect1">
311 <a name="GUPnPDeviceInfo.other"></a><h2>Types and Values</h2>
312 <div class="informaltable"><table width="100%" border="0">
313 <colgroup>
314 <col width="150px" class="name">
315 <col class="description">
316 </colgroup>
317 <tbody><tr>
318 <td class="datatype_keyword">struct</td>
319 <td class="function_name"><a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo-struct" title="struct GUPnPDeviceInfo">GUPnPDeviceInfo</a></td>
320 </tr></tbody>
321 </table></div>
322 </div>
323 <div class="refsect1">
324 <a name="GUPnPDeviceInfo.object-hierarchy"></a><h2>Object Hierarchy</h2>
325 <pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
326     <span class="lineart">╰──</span> GUPnPDeviceInfo
327         <span class="lineart">├──</span> <a class="link" href="GUPnPDevice.html" title="GUPnPDevice">GUPnPDevice</a>
328         <span class="lineart">╰──</span> <a class="link" href="GUPnPDeviceProxy.html" title="GUPnPDeviceProxy">GUPnPDeviceProxy</a>
329 </pre>
330 </div>
331 <div class="refsect1">
332 <a name="GUPnPDeviceInfo.description"></a><h2>Description</h2>
333 <p>The <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> base abstract class provides methods for querying
334 device information.</p>
335 </div>
336 <div class="refsect1">
337 <a name="GUPnPDeviceInfo.functions_details"></a><h2>Functions</h2>
338 <div class="refsect2">
339 <a name="gupnp-device-info-get-resource-factory"></a><h3>gupnp_device_info_get_resource_factory ()</h3>
340 <pre class="programlisting"><a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="returnvalue">GUPnPResourceFactory</span></a> *
341 gupnp_device_info_get_resource_factory
342                                (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *device_info</code></em>);</pre>
343 <p>Get the <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a> used by the <em class="parameter"><code>device_info</code></em>
344 .</p>
345 <div class="refsect3">
346 <a name="id-1.3.2.2.8.2.5"></a><h4>Parameters</h4>
347 <div class="informaltable"><table width="100%" border="0">
348 <colgroup>
349 <col width="150px" class="parameters_name">
350 <col class="parameters_description">
351 <col width="200px" class="parameters_annotations">
352 </colgroup>
353 <tbody><tr>
354 <td class="parameter_name"><p>device_info</p></td>
355 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
356 <td class="parameter_annotations"> </td>
357 </tr></tbody>
358 </table></div>
359 </div>
360 <div class="refsect3">
361 <a name="id-1.3.2.2.8.2.6"></a><h4>Returns</h4>
362 <p> A <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a>. </p>
363 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
364 </div>
365 </div>
366 <hr>
367 <div class="refsect2">
368 <a name="gupnp-device-info-get-context"></a><h3>gupnp_device_info_get_context ()</h3>
369 <pre class="programlisting"><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="returnvalue">GUPnPContext</span></a> *
370 gupnp_device_info_get_context (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
371 <p>Get the associated <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>.</p>
372 <div class="refsect3">
373 <a name="id-1.3.2.2.8.3.5"></a><h4>Parameters</h4>
374 <div class="informaltable"><table width="100%" border="0">
375 <colgroup>
376 <col width="150px" class="parameters_name">
377 <col class="parameters_description">
378 <col width="200px" class="parameters_annotations">
379 </colgroup>
380 <tbody><tr>
381 <td class="parameter_name"><p>info</p></td>
382 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
383 <td class="parameter_annotations"> </td>
384 </tr></tbody>
385 </table></div>
386 </div>
387 <div class="refsect3">
388 <a name="id-1.3.2.2.8.3.6"></a><h4>Returns</h4>
389 <p> A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>. </p>
390 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
391 </div>
392 </div>
393 <hr>
394 <div class="refsect2">
395 <a name="gupnp-device-info-get-location"></a><h3>gupnp_device_info_get_location ()</h3>
396 <pre class="programlisting">const <span class="returnvalue">char</span> *
397 gupnp_device_info_get_location (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
398 <p>Get the location of the device description file.</p>
399 <div class="refsect3">
400 <a name="id-1.3.2.2.8.4.5"></a><h4>Parameters</h4>
401 <div class="informaltable"><table width="100%" border="0">
402 <colgroup>
403 <col width="150px" class="parameters_name">
404 <col class="parameters_description">
405 <col width="200px" class="parameters_annotations">
406 </colgroup>
407 <tbody><tr>
408 <td class="parameter_name"><p>info</p></td>
409 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
410 <td class="parameter_annotations"> </td>
411 </tr></tbody>
412 </table></div>
413 </div>
414 <div class="refsect3">
415 <a name="id-1.3.2.2.8.4.6"></a><h4>Returns</h4>
416 <p> A constant string.</p>
417 <p></p>
418 </div>
419 </div>
420 <hr>
421 <div class="refsect2">
422 <a name="gupnp-device-info-get-url-base"></a><h3>gupnp_device_info_get_url_base ()</h3>
423 <pre class="programlisting">const <a href="/usr/share/gtk-doc/html/libsoup-2.4/SoupURI.html"><span class="returnvalue">SoupURI</span></a> *
424 gupnp_device_info_get_url_base (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
425 <p>Get the URL base of this device.</p>
426 <div class="refsect3">
427 <a name="id-1.3.2.2.8.5.5"></a><h4>Parameters</h4>
428 <div class="informaltable"><table width="100%" border="0">
429 <colgroup>
430 <col width="150px" class="parameters_name">
431 <col class="parameters_description">
432 <col width="200px" class="parameters_annotations">
433 </colgroup>
434 <tbody><tr>
435 <td class="parameter_name"><p>info</p></td>
436 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
437 <td class="parameter_annotations"> </td>
438 </tr></tbody>
439 </table></div>
440 </div>
441 <div class="refsect3">
442 <a name="id-1.3.2.2.8.5.6"></a><h4>Returns</h4>
443 <p> A <a href="/usr/share/gtk-doc/html/libsoup-2.4/SoupURI.html"><span class="type">SoupURI</span></a>.</p>
444 <p></p>
445 </div>
446 </div>
447 <hr>
448 <div class="refsect2">
449 <a name="gupnp-device-info-get-udn"></a><h3>gupnp_device_info_get_udn ()</h3>
450 <pre class="programlisting">const <span class="returnvalue">char</span> *
451 gupnp_device_info_get_udn (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
452 <p>Get the Unique Device Name of the device.</p>
453 <div class="refsect3">
454 <a name="id-1.3.2.2.8.6.5"></a><h4>Parameters</h4>
455 <div class="informaltable"><table width="100%" border="0">
456 <colgroup>
457 <col width="150px" class="parameters_name">
458 <col class="parameters_description">
459 <col width="200px" class="parameters_annotations">
460 </colgroup>
461 <tbody><tr>
462 <td class="parameter_name"><p>info</p></td>
463 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
464 <td class="parameter_annotations"> </td>
465 </tr></tbody>
466 </table></div>
467 </div>
468 <div class="refsect3">
469 <a name="id-1.3.2.2.8.6.6"></a><h4>Returns</h4>
470 <p> A constant string.</p>
471 <p></p>
472 </div>
473 </div>
474 <hr>
475 <div class="refsect2">
476 <a name="gupnp-device-info-get-device-type"></a><h3>gupnp_device_info_get_device_type ()</h3>
477 <pre class="programlisting">const <span class="returnvalue">char</span> *
478 gupnp_device_info_get_device_type (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
479 <p>Get the UPnP device type.</p>
480 <div class="refsect3">
481 <a name="id-1.3.2.2.8.7.5"></a><h4>Parameters</h4>
482 <div class="informaltable"><table width="100%" border="0">
483 <colgroup>
484 <col width="150px" class="parameters_name">
485 <col class="parameters_description">
486 <col width="200px" class="parameters_annotations">
487 </colgroup>
488 <tbody><tr>
489 <td class="parameter_name"><p>info</p></td>
490 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
491 <td class="parameter_annotations"> </td>
492 </tr></tbody>
493 </table></div>
494 </div>
495 <div class="refsect3">
496 <a name="id-1.3.2.2.8.7.6"></a><h4>Returns</h4>
497 <p> A constant string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
498 <p></p>
499 </div>
500 </div>
501 <hr>
502 <div class="refsect2">
503 <a name="gupnp-device-info-get-friendly-name"></a><h3>gupnp_device_info_get_friendly_name ()</h3>
504 <pre class="programlisting"><span class="returnvalue">char</span> *
505 gupnp_device_info_get_friendly_name (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
506 <p>Get the friendly name of the device.</p>
507 <div class="refsect3">
508 <a name="id-1.3.2.2.8.8.5"></a><h4>Parameters</h4>
509 <div class="informaltable"><table width="100%" border="0">
510 <colgroup>
511 <col width="150px" class="parameters_name">
512 <col class="parameters_description">
513 <col width="200px" class="parameters_annotations">
514 </colgroup>
515 <tbody><tr>
516 <td class="parameter_name"><p>info</p></td>
517 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
518 <td class="parameter_annotations"> </td>
519 </tr></tbody>
520 </table></div>
521 </div>
522 <div class="refsect3">
523 <a name="id-1.3.2.2.8.8.6"></a><h4>Returns</h4>
524 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
525 <p></p>
526 </div>
527 </div>
528 <hr>
529 <div class="refsect2">
530 <a name="gupnp-device-info-get-manufacturer"></a><h3>gupnp_device_info_get_manufacturer ()</h3>
531 <pre class="programlisting"><span class="returnvalue">char</span> *
532 gupnp_device_info_get_manufacturer (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
533 <p>Get the manufacturer of the device.</p>
534 <div class="refsect3">
535 <a name="id-1.3.2.2.8.9.5"></a><h4>Parameters</h4>
536 <div class="informaltable"><table width="100%" border="0">
537 <colgroup>
538 <col width="150px" class="parameters_name">
539 <col class="parameters_description">
540 <col width="200px" class="parameters_annotations">
541 </colgroup>
542 <tbody><tr>
543 <td class="parameter_name"><p>info</p></td>
544 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
545 <td class="parameter_annotations"> </td>
546 </tr></tbody>
547 </table></div>
548 </div>
549 <div class="refsect3">
550 <a name="id-1.3.2.2.8.9.6"></a><h4>Returns</h4>
551 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
552 <p></p>
553 </div>
554 </div>
555 <hr>
556 <div class="refsect2">
557 <a name="gupnp-device-info-get-manufacturer-url"></a><h3>gupnp_device_info_get_manufacturer_url ()</h3>
558 <pre class="programlisting"><span class="returnvalue">char</span> *
559 gupnp_device_info_get_manufacturer_url
560                                (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
561 <p>Get a URL pointing to the manufacturer's website.</p>
562 <div class="refsect3">
563 <a name="id-1.3.2.2.8.10.5"></a><h4>Parameters</h4>
564 <div class="informaltable"><table width="100%" border="0">
565 <colgroup>
566 <col width="150px" class="parameters_name">
567 <col class="parameters_description">
568 <col width="200px" class="parameters_annotations">
569 </colgroup>
570 <tbody><tr>
571 <td class="parameter_name"><p>info</p></td>
572 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
573 <td class="parameter_annotations"> </td>
574 </tr></tbody>
575 </table></div>
576 </div>
577 <div class="refsect3">
578 <a name="id-1.3.2.2.8.10.6"></a><h4>Returns</h4>
579 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
580 <p></p>
581 </div>
582 </div>
583 <hr>
584 <div class="refsect2">
585 <a name="gupnp-device-info-get-model-description"></a><h3>gupnp_device_info_get_model_description ()</h3>
586 <pre class="programlisting"><span class="returnvalue">char</span> *
587 gupnp_device_info_get_model_description
588                                (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
589 <p>Get the description of the device model.</p>
590 <div class="refsect3">
591 <a name="id-1.3.2.2.8.11.5"></a><h4>Parameters</h4>
592 <div class="informaltable"><table width="100%" border="0">
593 <colgroup>
594 <col width="150px" class="parameters_name">
595 <col class="parameters_description">
596 <col width="200px" class="parameters_annotations">
597 </colgroup>
598 <tbody><tr>
599 <td class="parameter_name"><p>info</p></td>
600 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
601 <td class="parameter_annotations"> </td>
602 </tr></tbody>
603 </table></div>
604 </div>
605 <div class="refsect3">
606 <a name="id-1.3.2.2.8.11.6"></a><h4>Returns</h4>
607 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
608 <p></p>
609 </div>
610 </div>
611 <hr>
612 <div class="refsect2">
613 <a name="gupnp-device-info-get-model-name"></a><h3>gupnp_device_info_get_model_name ()</h3>
614 <pre class="programlisting"><span class="returnvalue">char</span> *
615 gupnp_device_info_get_model_name (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
616 <p>Get the model name of the device.</p>
617 <div class="refsect3">
618 <a name="id-1.3.2.2.8.12.5"></a><h4>Parameters</h4>
619 <div class="informaltable"><table width="100%" border="0">
620 <colgroup>
621 <col width="150px" class="parameters_name">
622 <col class="parameters_description">
623 <col width="200px" class="parameters_annotations">
624 </colgroup>
625 <tbody><tr>
626 <td class="parameter_name"><p>info</p></td>
627 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
628 <td class="parameter_annotations"> </td>
629 </tr></tbody>
630 </table></div>
631 </div>
632 <div class="refsect3">
633 <a name="id-1.3.2.2.8.12.6"></a><h4>Returns</h4>
634 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
635 <p></p>
636 </div>
637 </div>
638 <hr>
639 <div class="refsect2">
640 <a name="gupnp-device-info-get-model-number"></a><h3>gupnp_device_info_get_model_number ()</h3>
641 <pre class="programlisting"><span class="returnvalue">char</span> *
642 gupnp_device_info_get_model_number (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
643 <p>Get the model number of the device.</p>
644 <div class="refsect3">
645 <a name="id-1.3.2.2.8.13.5"></a><h4>Parameters</h4>
646 <div class="informaltable"><table width="100%" border="0">
647 <colgroup>
648 <col width="150px" class="parameters_name">
649 <col class="parameters_description">
650 <col width="200px" class="parameters_annotations">
651 </colgroup>
652 <tbody><tr>
653 <td class="parameter_name"><p>info</p></td>
654 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
655 <td class="parameter_annotations"> </td>
656 </tr></tbody>
657 </table></div>
658 </div>
659 <div class="refsect3">
660 <a name="id-1.3.2.2.8.13.6"></a><h4>Returns</h4>
661 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
662 <p></p>
663 </div>
664 </div>
665 <hr>
666 <div class="refsect2">
667 <a name="gupnp-device-info-get-model-url"></a><h3>gupnp_device_info_get_model_url ()</h3>
668 <pre class="programlisting"><span class="returnvalue">char</span> *
669 gupnp_device_info_get_model_url (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
670 <p>Get a URL pointing to the device model's website.</p>
671 <div class="refsect3">
672 <a name="id-1.3.2.2.8.14.5"></a><h4>Parameters</h4>
673 <div class="informaltable"><table width="100%" border="0">
674 <colgroup>
675 <col width="150px" class="parameters_name">
676 <col class="parameters_description">
677 <col width="200px" class="parameters_annotations">
678 </colgroup>
679 <tbody><tr>
680 <td class="parameter_name"><p>info</p></td>
681 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
682 <td class="parameter_annotations"> </td>
683 </tr></tbody>
684 </table></div>
685 </div>
686 <div class="refsect3">
687 <a name="id-1.3.2.2.8.14.6"></a><h4>Returns</h4>
688 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
689 <p></p>
690 </div>
691 </div>
692 <hr>
693 <div class="refsect2">
694 <a name="gupnp-device-info-get-serial-number"></a><h3>gupnp_device_info_get_serial_number ()</h3>
695 <pre class="programlisting"><span class="returnvalue">char</span> *
696 gupnp_device_info_get_serial_number (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
697 <p>Get the serial number of the device.</p>
698 <div class="refsect3">
699 <a name="id-1.3.2.2.8.15.5"></a><h4>Parameters</h4>
700 <div class="informaltable"><table width="100%" border="0">
701 <colgroup>
702 <col width="150px" class="parameters_name">
703 <col class="parameters_description">
704 <col width="200px" class="parameters_annotations">
705 </colgroup>
706 <tbody><tr>
707 <td class="parameter_name"><p>info</p></td>
708 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
709 <td class="parameter_annotations"> </td>
710 </tr></tbody>
711 </table></div>
712 </div>
713 <div class="refsect3">
714 <a name="id-1.3.2.2.8.15.6"></a><h4>Returns</h4>
715 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
716 <p></p>
717 </div>
718 </div>
719 <hr>
720 <div class="refsect2">
721 <a name="gupnp-device-info-get-presentation-url"></a><h3>gupnp_device_info_get_presentation_url ()</h3>
722 <pre class="programlisting"><span class="returnvalue">char</span> *
723 gupnp_device_info_get_presentation_url
724                                (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
725 <p>Get a URL pointing to the device's presentation page, for web-based
726 administration.</p>
727 <div class="refsect3">
728 <a name="id-1.3.2.2.8.16.5"></a><h4>Parameters</h4>
729 <div class="informaltable"><table width="100%" border="0">
730 <colgroup>
731 <col width="150px" class="parameters_name">
732 <col class="parameters_description">
733 <col width="200px" class="parameters_annotations">
734 </colgroup>
735 <tbody><tr>
736 <td class="parameter_name"><p>info</p></td>
737 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
738 <td class="parameter_annotations"> </td>
739 </tr></tbody>
740 </table></div>
741 </div>
742 <div class="refsect3">
743 <a name="id-1.3.2.2.8.16.6"></a><h4>Returns</h4>
744 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
745 <p></p>
746 </div>
747 </div>
748 <hr>
749 <div class="refsect2">
750 <a name="gupnp-device-info-get-upc"></a><h3>gupnp_device_info_get_upc ()</h3>
751 <pre class="programlisting"><span class="returnvalue">char</span> *
752 gupnp_device_info_get_upc (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
753 <p>Get the Universal Product Code of the device.</p>
754 <div class="refsect3">
755 <a name="id-1.3.2.2.8.17.5"></a><h4>Parameters</h4>
756 <div class="informaltable"><table width="100%" border="0">
757 <colgroup>
758 <col width="150px" class="parameters_name">
759 <col class="parameters_description">
760 <col width="200px" class="parameters_annotations">
761 </colgroup>
762 <tbody><tr>
763 <td class="parameter_name"><p>info</p></td>
764 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
765 <td class="parameter_annotations"> </td>
766 </tr></tbody>
767 </table></div>
768 </div>
769 <div class="refsect3">
770 <a name="id-1.3.2.2.8.17.6"></a><h4>Returns</h4>
771 <p> A string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.</p>
772 <p></p>
773 </div>
774 </div>
775 <hr>
776 <div class="refsect2">
777 <a name="gupnp-device-info-get-icon-url"></a><h3>gupnp_device_info_get_icon_url ()</h3>
778 <pre class="programlisting"><span class="returnvalue">char</span> *
779 gupnp_device_info_get_icon_url (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
780                                 <em class="parameter"><code>const <span class="type">char</span> *requested_mime_type</code></em>,
781                                 <em class="parameter"><code><span class="type">int</span> requested_depth</code></em>,
782                                 <em class="parameter"><code><span class="type">int</span> requested_width</code></em>,
783                                 <em class="parameter"><code><span class="type">int</span> requested_height</code></em>,
784                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> prefer_bigger</code></em>,
785                                 <em class="parameter"><code><span class="type">char</span> **mime_type</code></em>,
786                                 <em class="parameter"><code><span class="type">int</span> *depth</code></em>,
787                                 <em class="parameter"><code><span class="type">int</span> *width</code></em>,
788                                 <em class="parameter"><code><span class="type">int</span> *height</code></em>);</pre>
789 <p>Get a URL pointing to the icon most closely matching the
790 given criteria, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If <em class="parameter"><code>requested_mime_type</code></em>
791  is set, only icons with
792 this mime type will be returned. If <em class="parameter"><code>requested_depth</code></em>
793  is set, only icons with
794 this or lower depth will be returned. If <em class="parameter"><code>requested_width</code></em>
795  and/or
796 <em class="parameter"><code>requested_height</code></em>
797  are set, only icons that are this size or smaller are
798 returned, unless <em class="parameter"><code>prefer_bigger</code></em>
799  is set, in which case the next biggest icon
800 will be returned. The returned strings should be freed.</p>
801 <div class="refsect3">
802 <a name="id-1.3.2.2.8.18.5"></a><h4>Parameters</h4>
803 <div class="informaltable"><table width="100%" border="0">
804 <colgroup>
805 <col width="150px" class="parameters_name">
806 <col class="parameters_description">
807 <col width="200px" class="parameters_annotations">
808 </colgroup>
809 <tbody>
810 <tr>
811 <td class="parameter_name"><p>info</p></td>
812 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
813 <td class="parameter_annotations"> </td>
814 </tr>
815 <tr>
816 <td class="parameter_name"><p>requested_mime_type</p></td>
817 <td class="parameter_description"><p> The requested file
818 format, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for any. </p></td>
819 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
820 </tr>
821 <tr>
822 <td class="parameter_name"><p>requested_depth</p></td>
823 <td class="parameter_description"><p>The requested color depth, or -1 for any</p></td>
824 <td class="parameter_annotations"> </td>
825 </tr>
826 <tr>
827 <td class="parameter_name"><p>requested_width</p></td>
828 <td class="parameter_description"><p>The requested width, or -1 for any</p></td>
829 <td class="parameter_annotations"> </td>
830 </tr>
831 <tr>
832 <td class="parameter_name"><p>requested_height</p></td>
833 <td class="parameter_description"><p>The requested height, or -1 for any</p></td>
834 <td class="parameter_annotations"> </td>
835 </tr>
836 <tr>
837 <td class="parameter_name"><p>prefer_bigger</p></td>
838 <td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a bigger, rather than a smaller icon should be
839 returned if no exact match could be found</p></td>
840 <td class="parameter_annotations"> </td>
841 </tr>
842 <tr>
843 <td class="parameter_name"><p>mime_type</p></td>
844 <td class="parameter_description"><p> The location where to store the the format
845 of the returned icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The returned string should be freed after
846 use. </p></td>
847 <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
848 </tr>
849 <tr>
850 <td class="parameter_name"><p>depth</p></td>
851 <td class="parameter_description"><p>(out) (allow-none) :  The location where to store the depth of the
852 returned icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
853 <td class="parameter_annotations"> </td>
854 </tr>
855 <tr>
856 <td class="parameter_name"><p>width</p></td>
857 <td class="parameter_description"><p>(out) (allow-none) : The location where to store the width of the
858 returned icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
859 <td class="parameter_annotations"> </td>
860 </tr>
861 <tr>
862 <td class="parameter_name"><p>height</p></td>
863 <td class="parameter_description"><p>(out) (allow-none) : The location where to store the height of the
864 returned icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
865 <td class="parameter_annotations"> </td>
866 </tr>
867 </tbody>
868 </table></div>
869 </div>
870 <div class="refsect3">
871 <a name="id-1.3.2.2.8.18.6"></a><h4>Returns</h4>
872 <p> a string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.  <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use. </p>
873 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
874 </div>
875 </div>
876 <hr>
877 <div class="refsect2">
878 <a name="gupnp-device-info-list-dlna-capabilities"></a><h3>gupnp_device_info_list_dlna_capabilities ()</h3>
879 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
880 gupnp_device_info_list_dlna_capabilities
881                                (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
882 <p>Get a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of strings that represent the device capabilities as announced
883 in the device description file using the &lt;dlna:X_DLNACAP&gt; element.</p>
884 <div class="refsect3">
885 <a name="id-1.3.2.2.8.19.5"></a><h4>Parameters</h4>
886 <div class="informaltable"><table width="100%" border="0">
887 <colgroup>
888 <col width="150px" class="parameters_name">
889 <col class="parameters_description">
890 <col width="200px" class="parameters_annotations">
891 </colgroup>
892 <tbody><tr>
893 <td class="parameter_name"><p>info</p></td>
894 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
895 <td class="parameter_annotations"> </td>
896 </tr></tbody>
897 </table></div>
898 </div>
899 <div class="refsect3">
900 <a name="id-1.3.2.2.8.19.6"></a><h4>Returns</h4>
901 <p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of newly allocated strings or
902 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the device description doesn't contain the &lt;dlna:X_DLNACAP&gt;
903 element. </p>
904 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></p>
905 </div>
906 <p class="since">Since 0.13.0</p>
907 </div>
908 <hr>
909 <div class="refsect2">
910 <a name="gupnp-device-info-list-dlna-device-class-identifier"></a><h3>gupnp_device_info_list_dlna_device_class_identifier ()</h3>
911 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
912 gupnp_device_info_list_dlna_device_class_identifier
913                                (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
914 <p>Get a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of strings that represent the device class and version as
915 announced in the device description file using the &lt;dlna:X_DLNADOC&gt;
916 element.</p>
917 <div class="refsect3">
918 <a name="id-1.3.2.2.8.20.5"></a><h4>Parameters</h4>
919 <div class="informaltable"><table width="100%" border="0">
920 <colgroup>
921 <col width="150px" class="parameters_name">
922 <col class="parameters_description">
923 <col width="200px" class="parameters_annotations">
924 </colgroup>
925 <tbody><tr>
926 <td class="parameter_name"><p>info</p></td>
927 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
928 <td class="parameter_annotations"> </td>
929 </tr></tbody>
930 </table></div>
931 </div>
932 <div class="refsect3">
933 <a name="id-1.3.2.2.8.20.6"></a><h4>Returns</h4>
934 <p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of newly allocated strings or
935 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the device description doesn't contain the &lt;dlna:X_DLNADOC&gt;
936 element. </p>
937 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></p>
938 </div>
939 <p class="since">Since 0.20.4</p>
940 </div>
941 <hr>
942 <div class="refsect2">
943 <a name="gupnp-device-info-get-description-value"></a><h3>gupnp_device_info_get_description_value ()</h3>
944 <pre class="programlisting"><span class="returnvalue">char</span> *
945 gupnp_device_info_get_description_value
946                                (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
947                                 <em class="parameter"><code>const <span class="type">char</span> *element</code></em>);</pre>
948 <p>This function provides generic access to the contents of arbitrary elements
949 in the device description file.</p>
950 <div class="refsect3">
951 <a name="id-1.3.2.2.8.21.5"></a><h4>Parameters</h4>
952 <div class="informaltable"><table width="100%" border="0">
953 <colgroup>
954 <col width="150px" class="parameters_name">
955 <col class="parameters_description">
956 <col width="200px" class="parameters_annotations">
957 </colgroup>
958 <tbody>
959 <tr>
960 <td class="parameter_name"><p>info</p></td>
961 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
962 <td class="parameter_annotations"> </td>
963 </tr>
964 <tr>
965 <td class="parameter_name"><p>element</p></td>
966 <td class="parameter_description"><p>Name of the description element to retrieve</p></td>
967 <td class="parameter_annotations"> </td>
968 </tr>
969 </tbody>
970 </table></div>
971 </div>
972 <div class="refsect3">
973 <a name="id-1.3.2.2.8.21.6"></a><h4>Returns</h4>
974 <p> a newly allocated string or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the device
975 description doesn't contain the given <em class="parameter"><code>element</code></em>
976 </p>
977 <p></p>
978 </div>
979 <p class="since">Since 0.13.0</p>
980 </div>
981 <hr>
982 <div class="refsect2">
983 <a name="gupnp-device-info-list-devices"></a><h3>gupnp_device_info_list_devices ()</h3>
984 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
985 gupnp_device_info_list_devices (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
986 <p>Get a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of new objects implementing <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
987 representing the devices directly contained in <em class="parameter"><code>info</code></em>
988 . The returned list
989 should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>'d and the elements should be <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>'d.</p>
990 <p>Note that devices are not cached internally, so that every time you
991 call this function new objects are created. The application
992 must cache any used devices if it wishes to keep them around and re-use
993 them.</p>
994 <div class="refsect3">
995 <a name="id-1.3.2.2.8.22.6"></a><h4>Parameters</h4>
996 <div class="informaltable"><table width="100%" border="0">
997 <colgroup>
998 <col width="150px" class="parameters_name">
999 <col class="parameters_description">
1000 <col width="200px" class="parameters_annotations">
1001 </colgroup>
1002 <tbody><tr>
1003 <td class="parameter_name"><p>info</p></td>
1004 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
1005 <td class="parameter_annotations"> </td>
1006 </tr></tbody>
1007 </table></div>
1008 </div>
1009 <div class="refsect3">
1010 <a name="id-1.3.2.2.8.22.7"></a><h4>Returns</h4>
1011 <p> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of
1012 new <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> objects. </p>
1013 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GUPnP.DeviceInfo][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1014 </div>
1015 </div>
1016 <hr>
1017 <div class="refsect2">
1018 <a name="gupnp-device-info-list-device-types"></a><h3>gupnp_device_info_list_device_types ()</h3>
1019 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
1020 gupnp_device_info_list_device_types (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
1021 <p>Get a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of strings representing the types of the devices
1022 directly contained in <em class="parameter"><code>info</code></em>
1023 .</p>
1024 <div class="refsect3">
1025 <a name="id-1.3.2.2.8.23.5"></a><h4>Parameters</h4>
1026 <div class="informaltable"><table width="100%" border="0">
1027 <colgroup>
1028 <col width="150px" class="parameters_name">
1029 <col class="parameters_description">
1030 <col width="200px" class="parameters_annotations">
1031 </colgroup>
1032 <tbody><tr>
1033 <td class="parameter_name"><p>info</p></td>
1034 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
1035 <td class="parameter_annotations"> </td>
1036 </tr></tbody>
1037 </table></div>
1038 </div>
1039 <div class="refsect3">
1040 <a name="id-1.3.2.2.8.23.6"></a><h4>Returns</h4>
1041 <p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of strings. The
1042 elements should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>'d and the list should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>'d. </p>
1043 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1044 </div>
1045 </div>
1046 <hr>
1047 <div class="refsect2">
1048 <a name="gupnp-device-info-get-device"></a><h3>gupnp_device_info_get_device ()</h3>
1049 <pre class="programlisting"><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="returnvalue">GUPnPDeviceInfo</span></a> *
1050 gupnp_device_info_get_device (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
1051                               <em class="parameter"><code>const <span class="type">char</span> *type</code></em>);</pre>
1052 <p>Get the service with type <em class="parameter"><code>type</code></em>
1053  directly contained in <em class="parameter"><code>info</code></em>
1054  as
1055 a new object implementing <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such device
1056 was found. The returned object should be unreffed when done.</p>
1057 <p>Note that devices are not cached internally, so that every time you call
1058 this function a new object is created. The application must cache any used
1059 devices if it wishes to keep them around and re-use them.</p>
1060 <div class="refsect3">
1061 <a name="id-1.3.2.2.8.24.6"></a><h4>Parameters</h4>
1062 <div class="informaltable"><table width="100%" border="0">
1063 <colgroup>
1064 <col width="150px" class="parameters_name">
1065 <col class="parameters_description">
1066 <col width="200px" class="parameters_annotations">
1067 </colgroup>
1068 <tbody>
1069 <tr>
1070 <td class="parameter_name"><p>info</p></td>
1071 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
1072 <td class="parameter_annotations"> </td>
1073 </tr>
1074 <tr>
1075 <td class="parameter_name"><p>type</p></td>
1076 <td class="parameter_description"><p>The type of the device to be retrieved.</p></td>
1077 <td class="parameter_annotations"> </td>
1078 </tr>
1079 </tbody>
1080 </table></div>
1081 </div>
1082 <div class="refsect3">
1083 <a name="id-1.3.2.2.8.24.7"></a><h4>Returns</h4>
1084 <p> A new <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>. </p>
1085 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
1086 </div>
1087 </div>
1088 <hr>
1089 <div class="refsect2">
1090 <a name="gupnp-device-info-list-services"></a><h3>gupnp_device_info_list_services ()</h3>
1091 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
1092 gupnp_device_info_list_services (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
1093 <p>Get a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of new objects implementing <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> representing the
1094 services directly contained in <em class="parameter"><code>info</code></em>
1095 . The returned list should be
1096 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>'d and the elements should be <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>'d.</p>
1097 <p>Note that services are not cached internally, so that every time you call
1098 function new objects are created. The application must cache any used
1099 services if it wishes to keep them around and re-use them.</p>
1100 <div class="refsect3">
1101 <a name="id-1.3.2.2.8.25.6"></a><h4>Parameters</h4>
1102 <div class="informaltable"><table width="100%" border="0">
1103 <colgroup>
1104 <col width="150px" class="parameters_name">
1105 <col class="parameters_description">
1106 <col width="200px" class="parameters_annotations">
1107 </colgroup>
1108 <tbody><tr>
1109 <td class="parameter_name"><p>info</p></td>
1110 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
1111 <td class="parameter_annotations"> </td>
1112 </tr></tbody>
1113 </table></div>
1114 </div>
1115 <div class="refsect3">
1116 <a name="id-1.3.2.2.8.25.7"></a><h4>Returns</h4>
1117 <p> (element-type GUPnP.ServiceInfo) (transfer full) : A <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of
1118 new <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> objects.</p>
1119 <p></p>
1120 </div>
1121 </div>
1122 <hr>
1123 <div class="refsect2">
1124 <a name="gupnp-device-info-list-service-types"></a><h3>gupnp_device_info_list_service_types ()</h3>
1125 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
1126 gupnp_device_info_list_service_types (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
1127 <p>Get a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of strings representing the types of the services
1128 directly contained in <em class="parameter"><code>info</code></em>
1129 .</p>
1130 <div class="refsect3">
1131 <a name="id-1.3.2.2.8.26.5"></a><h4>Parameters</h4>
1132 <div class="informaltable"><table width="100%" border="0">
1133 <colgroup>
1134 <col width="150px" class="parameters_name">
1135 <col class="parameters_description">
1136 <col width="200px" class="parameters_annotations">
1137 </colgroup>
1138 <tbody><tr>
1139 <td class="parameter_name"><p>info</p></td>
1140 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
1141 <td class="parameter_annotations"> </td>
1142 </tr></tbody>
1143 </table></div>
1144 </div>
1145 <div class="refsect3">
1146 <a name="id-1.3.2.2.8.26.6"></a><h4>Returns</h4>
1147 <p> A <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of strings. The
1148 elements should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>'d and the list should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>'d. </p>
1149 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1150 </div>
1151 </div>
1152 <hr>
1153 <div class="refsect2">
1154 <a name="gupnp-device-info-get-service"></a><h3>gupnp_device_info_get_service ()</h3>
1155 <pre class="programlisting"><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="returnvalue">GUPnPServiceInfo</span></a> *
1156 gupnp_device_info_get_service (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
1157                                <em class="parameter"><code>const <span class="type">char</span> *type</code></em>);</pre>
1158 <p>Get the service with type <em class="parameter"><code>type</code></em>
1159  directly contained in <em class="parameter"><code>info</code></em>
1160  as a new object
1161 implementing <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such device was found. The
1162 returned object should be unreffed when done.</p>
1163 <p>Note that services are not cached internally, so that every time you call
1164 this function a new object is created. The application must cache any used
1165 services if it wishes to keep them around and re-use them.</p>
1166 <div class="refsect3">
1167 <a name="id-1.3.2.2.8.27.6"></a><h4>Parameters</h4>
1168 <div class="informaltable"><table width="100%" border="0">
1169 <colgroup>
1170 <col width="150px" class="parameters_name">
1171 <col class="parameters_description">
1172 <col width="200px" class="parameters_annotations">
1173 </colgroup>
1174 <tbody>
1175 <tr>
1176 <td class="parameter_name"><p>info</p></td>
1177 <td class="parameter_description"><p>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a></p></td>
1178 <td class="parameter_annotations"> </td>
1179 </tr>
1180 <tr>
1181 <td class="parameter_name"><p>type</p></td>
1182 <td class="parameter_description"><p>The type of the service to be retrieved.</p></td>
1183 <td class="parameter_annotations"> </td>
1184 </tr>
1185 </tbody>
1186 </table></div>
1187 </div>
1188 <div class="refsect3">
1189 <a name="id-1.3.2.2.8.27.7"></a><h4>Returns</h4>
1190 <p> A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>. </p>
1191 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
1192 </div>
1193 </div>
1194 </div>
1195 <div class="refsect1">
1196 <a name="GUPnPDeviceInfo.other_details"></a><h2>Types and Values</h2>
1197 <div class="refsect2">
1198 <a name="GUPnPDeviceInfo-struct"></a><h3>struct GUPnPDeviceInfo</h3>
1199 <pre class="programlisting">struct GUPnPDeviceInfo;</pre>
1200 <p>This struct contains private data only, and should be accessed using the
1201 functions below.</p>
1202 </div>
1203 </div>
1204 <div class="refsect1">
1205 <a name="GUPnPDeviceInfo.property-details"></a><h2>Property Details</h2>
1206 <div class="refsect2">
1207 <a name="GUPnPDeviceInfo--context"></a><h3>The <code class="literal">“context”</code> property</h3>
1208 <pre class="programlisting">  “context”                  <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *</pre>
1209 <p>The <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> to use.</p>
1210 <p>Flags: Read / Write / Construct Only</p>
1211 </div>
1212 <hr>
1213 <div class="refsect2">
1214 <a name="GUPnPDeviceInfo--device-type"></a><h3>The <code class="literal">“device-type”</code> property</h3>
1215 <pre class="programlisting">  “device-type”              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
1216 <p>The device type.</p>
1217 <p>Flags: Read / Write / Construct Only</p>
1218 <p>Default value: NULL</p>
1219 </div>
1220 <hr>
1221 <div class="refsect2">
1222 <a name="GUPnPDeviceInfo--document"></a><h3>The <code class="literal">“document”</code> property</h3>
1223 <pre class="programlisting">  “document”                 <a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a> *</pre>
1224 <p>Private property.</p>
1225 <p>Flags: Read / Write / Construct Only</p>
1226 <p class="stability">Stability Level: Private</p>
1227 </div>
1228 <hr>
1229 <div class="refsect2">
1230 <a name="GUPnPDeviceInfo--element"></a><h3>The <code class="literal">“element”</code> property</h3>
1231 <pre class="programlisting">  “element”                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></pre>
1232 <p>Private property.</p>
1233 <p>Flags: Write / Construct Only</p>
1234 <p class="stability">Stability Level: Private</p>
1235 </div>
1236 <hr>
1237 <div class="refsect2">
1238 <a name="GUPnPDeviceInfo--location"></a><h3>The <code class="literal">“location”</code> property</h3>
1239 <pre class="programlisting">  “location”                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
1240 <p>The location of the device description file.</p>
1241 <p>Flags: Read / Write / Construct Only</p>
1242 <p>Default value: NULL</p>
1243 </div>
1244 <hr>
1245 <div class="refsect2">
1246 <a name="GUPnPDeviceInfo--resource-factory"></a><h3>The <code class="literal">“resource-factory”</code> property</h3>
1247 <pre class="programlisting">  “resource-factory”         <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a> *</pre>
1248 <p>The resource factory to use. Set to NULL for default factory.</p>
1249 <p>Flags: Read / Write / Construct Only</p>
1250 </div>
1251 <hr>
1252 <div class="refsect2">
1253 <a name="GUPnPDeviceInfo--udn"></a><h3>The <code class="literal">“udn”</code> property</h3>
1254 <pre class="programlisting">  “udn”                      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
1255 <p>The UDN of this device.</p>
1256 <p>Flags: Read / Write / Construct Only</p>
1257 <p>Default value: NULL</p>
1258 </div>
1259 <hr>
1260 <div class="refsect2">
1261 <a name="GUPnPDeviceInfo--url-base"></a><h3>The <code class="literal">“url-base”</code> property</h3>
1262 <pre class="programlisting">  “url-base”                 <a href="/usr/share/gtk-doc/html/libsoup-2.4/SoupURI.html"><span class="type">SoupURI</span></a> *</pre>
1263 <p>The URL base (<a href="/usr/share/gtk-doc/html/libsoup-2.4/SoupURI.html"><span class="type">SoupURI</span></a>).</p>
1264 <p>Flags: Read / Write / Construct Only</p>
1265 </div>
1266 </div>
1267 </div>
1268 <div class="footer">
1269 <hr>
1270           Generated by GTK-Doc V1.20</div>
1271 </body>
1272 </html>