tizen 2.3.1 release
[external/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>GUPnPDeviceInfo</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-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.15.1 (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="2">
16 <tr valign="middle">
17 <td><a accesskey="p" href="api-device-info.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="api-device-info.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="GUPnPServiceInfo.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22 </tr>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GUPnPDeviceInfo.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#GUPnPDeviceInfo.description" class="shortcut">Description</a>
27                    | 
28                   <a href="#GUPnPDeviceInfo.object-hierarchy" class="shortcut">Object Hierarchy</a>
29                    | 
30                   <a href="#GUPnPDeviceInfo.properties" class="shortcut">Properties</a>
31 </td></tr>
32 </table>
33 <div class="refentry">
34 <a name="GUPnPDeviceInfo"></a><div class="titlepage"></div>
35 <div class="refnamediv"><table width="100%"><tr>
36 <td valign="top">
37 <h2><span class="refentrytitle"><a name="GUPnPDeviceInfo.top_of_page"></a>GUPnPDeviceInfo</span></h2>
38 <p>GUPnPDeviceInfo — Base abstract class for querying device information.</p>
39 </td>
40 <td valign="top" align="right"></td>
41 </tr></table></div>
42 <div class="refsynopsisdiv">
43 <a name="GUPnPDeviceInfo.synopsis"></a><h2>Synopsis</h2>
44 <pre class="synopsis">                    <a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo-struct" title="GUPnPDeviceInfo">GUPnPDeviceInfo</a>;
45 <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="returnvalue">GUPnPResourceFactory</span></a> * <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>
46                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *device_info</code></em>);
47 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="returnvalue">GUPnPContext</span></a> *      <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-context" title="gupnp_device_info_get_context ()">gupnp_device_info_get_context</a>       (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
48 const <span class="returnvalue">char</span> *        <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-location" title="gupnp_device_info_get_location ()">gupnp_device_info_get_location</a>      (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
49 const <span class="returnvalue">SoupURI</span> *     <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>      (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
50 const <span class="returnvalue">char</span> *        <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-udn" title="gupnp_device_info_get_udn ()">gupnp_device_info_get_udn</a>           (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
51 const <span class="returnvalue">char</span> *        <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>   (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
52 <span class="returnvalue">char</span> *              <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> (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
53 <span class="returnvalue">char</span> *              <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-manufacturer" title="gupnp_device_info_get_manufacturer ()">gupnp_device_info_get_manufacturer</a>  (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
54 <span class="returnvalue">char</span> *              <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>
55                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
56 <span class="returnvalue">char</span> *              <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>
57                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
58 <span class="returnvalue">char</span> *              <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>    (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
59 <span class="returnvalue">char</span> *              <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>  (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
60 <span class="returnvalue">char</span> *              <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>     (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
61 <span class="returnvalue">char</span> *              <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> (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
62 <span class="returnvalue">char</span> *              <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>
63                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
64 <span class="returnvalue">char</span> *              <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-upc" title="gupnp_device_info_get_upc ()">gupnp_device_info_get_upc</a>           (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
65 <span class="returnvalue">char</span> *              <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>      (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
66                                                          <em class="parameter"><code>const <span class="type">char</span> *requested_mime_type</code></em>,
67                                                          <em class="parameter"><code><span class="type">int</span> requested_depth</code></em>,
68                                                          <em class="parameter"><code><span class="type">int</span> requested_width</code></em>,
69                                                          <em class="parameter"><code><span class="type">int</span> requested_height</code></em>,
70                                                          <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>,
71                                                          <em class="parameter"><code><span class="type">char</span> **mime_type</code></em>,
72                                                          <em class="parameter"><code><span class="type">int</span> *depth</code></em>,
73                                                          <em class="parameter"><code><span class="type">int</span> *width</code></em>,
74                                                          <em class="parameter"><code><span class="type">int</span> *height</code></em>);
75 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <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>
76                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
77 <span class="returnvalue">char</span> *              <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>
78                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
79                                                          <em class="parameter"><code>const <span class="type">char</span> *element</code></em>);
80 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-list-devices" title="gupnp_device_info_list_devices ()">gupnp_device_info_list_devices</a>      (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
81 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <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> (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
82 <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="returnvalue">GUPnPDeviceInfo</span></a> *   <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-device" title="gupnp_device_info_get_device ()">gupnp_device_info_get_device</a>        (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
83                                                          <em class="parameter"><code>const <span class="type">char</span> *type</code></em>);
84 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-list-services" title="gupnp_device_info_list_services ()">gupnp_device_info_list_services</a>     (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
85 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <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>
86                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);
87 <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="returnvalue">GUPnPServiceInfo</span></a> *  <a class="link" href="GUPnPDeviceInfo.html#gupnp-device-info-get-service" title="gupnp_device_info_get_service ()">gupnp_device_info_get_service</a>       (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
88                                                          <em class="parameter"><code>const <span class="type">char</span> *type</code></em>);
89 </pre>
90 </div>
91 <div class="refsect1">
92 <a name="GUPnPDeviceInfo.object-hierarchy"></a><h2>Object Hierarchy</h2>
93 <pre class="synopsis">
94   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
95    +----GUPnPDeviceInfo
96          +----<a class="link" href="GUPnPDevice.html" title="GUPnPDevice">GUPnPDevice</a>
97          +----<a class="link" href="GUPnPDeviceProxy.html" title="GUPnPDeviceProxy">GUPnPDeviceProxy</a>
98 </pre>
99 </div>
100 <div class="refsect1">
101 <a name="GUPnPDeviceInfo.properties"></a><h2>Properties</h2>
102 <pre class="synopsis">
103   "<a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--context" title='The "context" property'>context</a>"                  <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>*         : Read / Write / Construct Only
104   "<a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--device-type" title='The "device-type" property'>device-type</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
105   "<a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--document" title='The "document" property'>document</a>"                 <a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a>*          : Write / Construct Only
106   "<a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--element" title='The "element" property'>element</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only
107   "<a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--location" title='The "location" property'>location</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
108   "<a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--resource-factory" title='The "resource-factory" property'>resource-factory</a>"         <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a>*  : Read / Write / Construct Only
109   "<a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--udn" title='The "udn" property'>udn</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
110   "<a class="link" href="GUPnPDeviceInfo.html#GUPnPDeviceInfo--url-base" title='The "url-base" property'>url-base</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write / Construct Only
111 </pre>
112 </div>
113 <div class="refsect1">
114 <a name="GUPnPDeviceInfo.description"></a><h2>Description</h2>
115 <p>
116 The <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> base abstract class provides methods for querying
117 device information.
118 </p>
119 <p>
120 </p>
121 </div>
122 <div class="refsect1">
123 <a name="GUPnPDeviceInfo.details"></a><h2>Details</h2>
124 <div class="refsect2">
125 <a name="GUPnPDeviceInfo-struct"></a><h3>GUPnPDeviceInfo</h3>
126 <pre class="programlisting">typedef struct _GUPnPDeviceInfo GUPnPDeviceInfo;</pre>
127 <p>
128 This struct contains private data only, and should be accessed using the
129 functions below.
130 </p>
131 <p>
132 </p>
133 </div>
134 <hr>
135 <div class="refsect2">
136 <a name="gupnp-device-info-get-resource-factory"></a><h3>gupnp_device_info_get_resource_factory ()</h3>
137 <pre class="programlisting"><a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="returnvalue">GUPnPResourceFactory</span></a> * gupnp_device_info_get_resource_factory
138                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *device_info</code></em>);</pre>
139 <p>
140 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>.
141 </p>
142 <p>
143 </p>
144 <div class="variablelist"><table border="0">
145 <col align="left" valign="top">
146 <tbody>
147 <tr>
148 <td><p><span class="term"><em class="parameter"><code>device_info</code></em> :</span></p></td>
149 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
150 </td>
151 </tr>
152 <tr>
153 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
154 <td> A <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a>.
155 </td>
156 </tr>
157 </tbody>
158 </table></div>
159 </div>
160 <hr>
161 <div class="refsect2">
162 <a name="gupnp-device-info-get-context"></a><h3>gupnp_device_info_get_context ()</h3>
163 <pre class="programlisting"><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="returnvalue">GUPnPContext</span></a> *      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>
164 <p>
165 Get the associated <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>.
166 </p>
167 <p>
168 </p>
169 <div class="variablelist"><table border="0">
170 <col align="left" valign="top">
171 <tbody>
172 <tr>
173 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
174 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
175 </td>
176 </tr>
177 <tr>
178 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
179 <td> A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>.
180 </td>
181 </tr>
182 </tbody>
183 </table></div>
184 </div>
185 <hr>
186 <div class="refsect2">
187 <a name="gupnp-device-info-get-location"></a><h3>gupnp_device_info_get_location ()</h3>
188 <pre class="programlisting">const <span class="returnvalue">char</span> *        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>
189 <p>
190 Get the location of the device description file.
191 </p>
192 <p>
193 </p>
194 <div class="variablelist"><table border="0">
195 <col align="left" valign="top">
196 <tbody>
197 <tr>
198 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
199 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
200 </td>
201 </tr>
202 <tr>
203 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
204 <td> A constant string.
205 </td>
206 </tr>
207 </tbody>
208 </table></div>
209 </div>
210 <hr>
211 <div class="refsect2">
212 <a name="gupnp-device-info-get-url-base"></a><h3>gupnp_device_info_get_url_base ()</h3>
213 <pre class="programlisting">const <span class="returnvalue">SoupURI</span> *     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>
214 <p>
215 Get the URL base of this device.
216 </p>
217 <p>
218 </p>
219 <div class="variablelist"><table border="0">
220 <col align="left" valign="top">
221 <tbody>
222 <tr>
223 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
224 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
225 </td>
226 </tr>
227 <tr>
228 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
229 <td> A <span class="type">SoupURI</span>.
230 </td>
231 </tr>
232 </tbody>
233 </table></div>
234 </div>
235 <hr>
236 <div class="refsect2">
237 <a name="gupnp-device-info-get-udn"></a><h3>gupnp_device_info_get_udn ()</h3>
238 <pre class="programlisting">const <span class="returnvalue">char</span> *        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>
239 <p>
240 Get the Unique Device Name of the device.
241 </p>
242 <p>
243 </p>
244 <div class="variablelist"><table border="0">
245 <col align="left" valign="top">
246 <tbody>
247 <tr>
248 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
249 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
250 </td>
251 </tr>
252 <tr>
253 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
254 <td> A constant string.
255 </td>
256 </tr>
257 </tbody>
258 </table></div>
259 </div>
260 <hr>
261 <div class="refsect2">
262 <a name="gupnp-device-info-get-device-type"></a><h3>gupnp_device_info_get_device_type ()</h3>
263 <pre class="programlisting">const <span class="returnvalue">char</span> *        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>
264 <p>
265 Get the UPnP device type.
266 </p>
267 <p>
268 </p>
269 <div class="variablelist"><table border="0">
270 <col align="left" valign="top">
271 <tbody>
272 <tr>
273 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
274 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
275 </td>
276 </tr>
277 <tr>
278 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
279 <td> 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>.
280 </td>
281 </tr>
282 </tbody>
283 </table></div>
284 </div>
285 <hr>
286 <div class="refsect2">
287 <a name="gupnp-device-info-get-friendly-name"></a><h3>gupnp_device_info_get_friendly_name ()</h3>
288 <pre class="programlisting"><span class="returnvalue">char</span> *              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>
289 <p>
290 Get the friendly name of the device.
291 </p>
292 <p>
293 </p>
294 <div class="variablelist"><table border="0">
295 <col align="left" valign="top">
296 <tbody>
297 <tr>
298 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
299 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
300 </td>
301 </tr>
302 <tr>
303 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
304 <td> 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.
305 </td>
306 </tr>
307 </tbody>
308 </table></div>
309 </div>
310 <hr>
311 <div class="refsect2">
312 <a name="gupnp-device-info-get-manufacturer"></a><h3>gupnp_device_info_get_manufacturer ()</h3>
313 <pre class="programlisting"><span class="returnvalue">char</span> *              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>
314 <p>
315 Get the manufacturer of the device.
316 </p>
317 <p>
318 </p>
319 <div class="variablelist"><table border="0">
320 <col align="left" valign="top">
321 <tbody>
322 <tr>
323 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
324 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
325 </td>
326 </tr>
327 <tr>
328 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
329 <td> 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.
330 </td>
331 </tr>
332 </tbody>
333 </table></div>
334 </div>
335 <hr>
336 <div class="refsect2">
337 <a name="gupnp-device-info-get-manufacturer-url"></a><h3>gupnp_device_info_get_manufacturer_url ()</h3>
338 <pre class="programlisting"><span class="returnvalue">char</span> *              gupnp_device_info_get_manufacturer_url
339                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
340 <p>
341 Get a URL pointing to the manufacturer's website.
342 </p>
343 <p>
344 </p>
345 <div class="variablelist"><table border="0">
346 <col align="left" valign="top">
347 <tbody>
348 <tr>
349 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
350 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
351 </td>
352 </tr>
353 <tr>
354 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
355 <td> 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.
356 </td>
357 </tr>
358 </tbody>
359 </table></div>
360 </div>
361 <hr>
362 <div class="refsect2">
363 <a name="gupnp-device-info-get-model-description"></a><h3>gupnp_device_info_get_model_description ()</h3>
364 <pre class="programlisting"><span class="returnvalue">char</span> *              gupnp_device_info_get_model_description
365                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
366 <p>
367 Get the description of the device model.
368 </p>
369 <p>
370 </p>
371 <div class="variablelist"><table border="0">
372 <col align="left" valign="top">
373 <tbody>
374 <tr>
375 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
376 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
377 </td>
378 </tr>
379 <tr>
380 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
381 <td> 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.
382 </td>
383 </tr>
384 </tbody>
385 </table></div>
386 </div>
387 <hr>
388 <div class="refsect2">
389 <a name="gupnp-device-info-get-model-name"></a><h3>gupnp_device_info_get_model_name ()</h3>
390 <pre class="programlisting"><span class="returnvalue">char</span> *              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>
391 <p>
392 Get the model name of the device.
393 </p>
394 <p>
395 </p>
396 <div class="variablelist"><table border="0">
397 <col align="left" valign="top">
398 <tbody>
399 <tr>
400 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
401 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
402 </td>
403 </tr>
404 <tr>
405 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
406 <td> 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.
407 </td>
408 </tr>
409 </tbody>
410 </table></div>
411 </div>
412 <hr>
413 <div class="refsect2">
414 <a name="gupnp-device-info-get-model-number"></a><h3>gupnp_device_info_get_model_number ()</h3>
415 <pre class="programlisting"><span class="returnvalue">char</span> *              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>
416 <p>
417 Get the model number of the device.
418 </p>
419 <p>
420 </p>
421 <div class="variablelist"><table border="0">
422 <col align="left" valign="top">
423 <tbody>
424 <tr>
425 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
426 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
427 </td>
428 </tr>
429 <tr>
430 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
431 <td> 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.
432 </td>
433 </tr>
434 </tbody>
435 </table></div>
436 </div>
437 <hr>
438 <div class="refsect2">
439 <a name="gupnp-device-info-get-model-url"></a><h3>gupnp_device_info_get_model_url ()</h3>
440 <pre class="programlisting"><span class="returnvalue">char</span> *              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>
441 <p>
442 Get a URL pointing to the device model's website.
443 </p>
444 <p>
445 </p>
446 <div class="variablelist"><table border="0">
447 <col align="left" valign="top">
448 <tbody>
449 <tr>
450 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
451 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
452 </td>
453 </tr>
454 <tr>
455 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
456 <td> 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.
457 </td>
458 </tr>
459 </tbody>
460 </table></div>
461 </div>
462 <hr>
463 <div class="refsect2">
464 <a name="gupnp-device-info-get-serial-number"></a><h3>gupnp_device_info_get_serial_number ()</h3>
465 <pre class="programlisting"><span class="returnvalue">char</span> *              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>
466 <p>
467 Get the serial number of the device.
468 </p>
469 <p>
470 </p>
471 <div class="variablelist"><table border="0">
472 <col align="left" valign="top">
473 <tbody>
474 <tr>
475 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
476 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
477 </td>
478 </tr>
479 <tr>
480 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
481 <td> 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.
482 </td>
483 </tr>
484 </tbody>
485 </table></div>
486 </div>
487 <hr>
488 <div class="refsect2">
489 <a name="gupnp-device-info-get-presentation-url"></a><h3>gupnp_device_info_get_presentation_url ()</h3>
490 <pre class="programlisting"><span class="returnvalue">char</span> *              gupnp_device_info_get_presentation_url
491                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
492 <p>
493 Get a URL pointing to the device's presentation page, for web-based
494 administration.
495 </p>
496 <p>
497 </p>
498 <div class="variablelist"><table border="0">
499 <col align="left" valign="top">
500 <tbody>
501 <tr>
502 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
503 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
504 </td>
505 </tr>
506 <tr>
507 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
508 <td> 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.
509 </td>
510 </tr>
511 </tbody>
512 </table></div>
513 </div>
514 <hr>
515 <div class="refsect2">
516 <a name="gupnp-device-info-get-upc"></a><h3>gupnp_device_info_get_upc ()</h3>
517 <pre class="programlisting"><span class="returnvalue">char</span> *              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>
518 <p>
519 Get the Universal Product Code of the device.
520 </p>
521 <p>
522 </p>
523 <div class="variablelist"><table border="0">
524 <col align="left" valign="top">
525 <tbody>
526 <tr>
527 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
528 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
529 </td>
530 </tr>
531 <tr>
532 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
533 <td> 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.
534 </td>
535 </tr>
536 </tbody>
537 </table></div>
538 </div>
539 <hr>
540 <div class="refsect2">
541 <a name="gupnp-device-info-get-icon-url"></a><h3>gupnp_device_info_get_icon_url ()</h3>
542 <pre class="programlisting"><span class="returnvalue">char</span> *              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>,
543                                                          <em class="parameter"><code>const <span class="type">char</span> *requested_mime_type</code></em>,
544                                                          <em class="parameter"><code><span class="type">int</span> requested_depth</code></em>,
545                                                          <em class="parameter"><code><span class="type">int</span> requested_width</code></em>,
546                                                          <em class="parameter"><code><span class="type">int</span> requested_height</code></em>,
547                                                          <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>,
548                                                          <em class="parameter"><code><span class="type">char</span> **mime_type</code></em>,
549                                                          <em class="parameter"><code><span class="type">int</span> *depth</code></em>,
550                                                          <em class="parameter"><code><span class="type">int</span> *width</code></em>,
551                                                          <em class="parameter"><code><span class="type">int</span> *height</code></em>);</pre>
552 <p>
553 Get a URL pointing to the icon most closely matching the
554 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> is set, only icons with
555 this mime type will be returned. If <em class="parameter"><code>requested_depth</code></em> is set, only icons with
556 this or lower depth will be returned. If <em class="parameter"><code>requested_width</code></em> and/or
557 <em class="parameter"><code>requested_height</code></em> are set, only icons that are this size or smaller are
558 returned, unless <em class="parameter"><code>prefer_bigger</code></em> is set, in which case the next biggest icon
559 will be returned. The returned strings should be freed.
560 </p>
561 <p>
562 </p>
563 <div class="variablelist"><table border="0">
564 <col align="left" valign="top">
565 <tbody>
566 <tr>
567 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
568 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
569 </td>
570 </tr>
571 <tr>
572 <td><p><span class="term"><em class="parameter"><code>requested_mime_type</code></em> :</span></p></td>
573 <td> The requested file
574 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. <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>
575 </td>
576 </tr>
577 <tr>
578 <td><p><span class="term"><em class="parameter"><code>requested_depth</code></em> :</span></p></td>
579 <td>The requested color depth, or -1 for any
580 </td>
581 </tr>
582 <tr>
583 <td><p><span class="term"><em class="parameter"><code>requested_width</code></em> :</span></p></td>
584 <td>The requested width, or -1 for any
585 </td>
586 </tr>
587 <tr>
588 <td><p><span class="term"><em class="parameter"><code>requested_height</code></em> :</span></p></td>
589 <td>The requested height, or -1 for any
590 </td>
591 </tr>
592 <tr>
593 <td><p><span class="term"><em class="parameter"><code>prefer_bigger</code></em> :</span></p></td>
594 <td>
595 <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
596 returned if no exact match could be found
597 </td>
598 </tr>
599 <tr>
600 <td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td>
601 <td> The location where to store the the format
602 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
603 use. <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>
604 </td>
605 </tr>
606 <tr>
607 <td><p><span class="term"><em class="parameter"><code>depth</code></em> :</span></p></td>
608 <td>(out) (allow-none) :  The location where to store the depth of the
609 returned icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
610 </td>
611 </tr>
612 <tr>
613 <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
614 <td>(out) (allow-none) : The location where to store the width of the
615 returned icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
616 </td>
617 </tr>
618 <tr>
619 <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
620 <td>(out) (allow-none) : The location where to store the height of the
621 returned icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
622 </td>
623 </tr>
624 <tr>
625 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
626 <td> 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. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
627 </td>
628 </tr>
629 </tbody>
630 </table></div>
631 </div>
632 <hr>
633 <div class="refsect2">
634 <a name="gupnp-device-info-list-dlna-capabilities"></a><h3>gupnp_device_info_list_dlna_capabilities ()</h3>
635 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gupnp_device_info_list_dlna_capabilities
636                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
637 <p>
638 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 
639 in the device description file using the &lt;dlna:X_DLNACAP&gt; element.
640 </p>
641 <p>
642 </p>
643 <div class="variablelist"><table border="0">
644 <col align="left" valign="top">
645 <tbody>
646 <tr>
647 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
648 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
649 </td>
650 </tr>
651 <tr>
652 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
653 <td> 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
654 <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;
655 element. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span>
656 </td>
657 </tr>
658 </tbody>
659 </table></div>
660 </div>
661 <hr>
662 <div class="refsect2">
663 <a name="gupnp-device-info-get-description-value"></a><h3>gupnp_device_info_get_description_value ()</h3>
664 <pre class="programlisting"><span class="returnvalue">char</span> *              gupnp_device_info_get_description_value
665                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>,
666                                                          <em class="parameter"><code>const <span class="type">char</span> *element</code></em>);</pre>
667 <p>
668 This function provides generic access to the contents of arbitrary elements
669 in the device description file.
670 </p>
671 <p>
672 </p>
673 <div class="variablelist"><table border="0">
674 <col align="left" valign="top">
675 <tbody>
676 <tr>
677 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
678 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
679 </td>
680 </tr>
681 <tr>
682 <td><p><span class="term"><em class="parameter"><code>element</code></em> :</span></p></td>
683 <td>Name of the description element to retrieve
684 </td>
685 </tr>
686 <tr>
687 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
688 <td> 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
689               description doesn't contain the given <em class="parameter"><code>element</code></em>
690 </td>
691 </tr>
692 </tbody>
693 </table></div>
694 </div>
695 <hr>
696 <div class="refsect2">
697 <a name="gupnp-device-info-list-devices"></a><h3>gupnp_device_info_list_devices ()</h3>
698 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             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>
699 <p>
700 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>
701 representing the devices directly contained in <em class="parameter"><code>info</code></em>. The returned list
702 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="/opt/gnome2/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-unref"><code class="function">g_object_unref()</code></a>'d.
703 </p>
704 <p>
705 Note that devices are not cached internally, so that every time you
706 call this function new objects are created. The application
707 must cache any used devices if it wishes to keep them around and re-use
708 them.
709 </p>
710 <p>
711 </p>
712 <div class="variablelist"><table border="0">
713 <col align="left" valign="top">
714 <tbody>
715 <tr>
716 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
717 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
718 </td>
719 </tr>
720 <tr>
721 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
722 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of
723 new <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> objects. <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>
724 </td>
725 </tr>
726 </tbody>
727 </table></div>
728 </div>
729 <hr>
730 <div class="refsect2">
731 <a name="gupnp-device-info-list-device-types"></a><h3>gupnp_device_info_list_device_types ()</h3>
732 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             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>
733 <p>
734 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
735 directly contained in <em class="parameter"><code>info</code></em>.
736 </p>
737 <p>
738 </p>
739 <div class="variablelist"><table border="0">
740 <col align="left" valign="top">
741 <tbody>
742 <tr>
743 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
744 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
745 </td>
746 </tr>
747 <tr>
748 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
749 <td> 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
750 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. <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>
751 </td>
752 </tr>
753 </tbody>
754 </table></div>
755 </div>
756 <hr>
757 <div class="refsect2">
758 <a name="gupnp-device-info-get-device"></a><h3>gupnp_device_info_get_device ()</h3>
759 <pre class="programlisting"><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="returnvalue">GUPnPDeviceInfo</span></a> *   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>,
760                                                          <em class="parameter"><code>const <span class="type">char</span> *type</code></em>);</pre>
761 <p>
762 Get the service with type <em class="parameter"><code>type</code></em> directly contained in <em class="parameter"><code>info</code></em> as
763 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
764 was found. The returned object should be unreffed when done.
765 </p>
766 <p>
767 Note that devices are not cached internally, so that every time you call
768 this function a new object is created. The application must cache any used
769 devices if it wishes to keep them around and re-use them.
770 </p>
771 <p>
772 </p>
773 <div class="variablelist"><table border="0">
774 <col align="left" valign="top">
775 <tbody>
776 <tr>
777 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
778 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
779 </td>
780 </tr>
781 <tr>
782 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
783 <td>The type of the device to be retrieved.
784 </td>
785 </tr>
786 <tr>
787 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
788 <td> A new <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>.
789 </td>
790 </tr>
791 </tbody>
792 </table></div>
793 </div>
794 <hr>
795 <div class="refsect2">
796 <a name="gupnp-device-info-list-services"></a><h3>gupnp_device_info_list_services ()</h3>
797 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             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>
798 <p>
799 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
800 services directly contained in <em class="parameter"><code>info</code></em>. The returned list should be
801 <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="/opt/gnome2/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-unref"><code class="function">g_object_unref()</code></a>'d.
802 </p>
803 <p>
804 Note that services are not cached internally, so that every time you call
805 function new objects are created. The application must cache any used
806 services if it wishes to keep them around and re-use them.
807 </p>
808 <p>
809 </p>
810 <div class="variablelist"><table border="0">
811 <col align="left" valign="top">
812 <tbody>
813 <tr>
814 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
815 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
816 </td>
817 </tr>
818 <tr>
819 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
820 <td> (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
821 new <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> objects.
822 </td>
823 </tr>
824 </tbody>
825 </table></div>
826 </div>
827 <hr>
828 <div class="refsect2">
829 <a name="gupnp-device-info-list-service-types"></a><h3>gupnp_device_info_list_service_types ()</h3>
830 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             gupnp_device_info_list_service_types
831                                                         (<em class="parameter"><code><a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> *info</code></em>);</pre>
832 <p>
833 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
834 directly contained in <em class="parameter"><code>info</code></em>.
835 </p>
836 <p>
837 </p>
838 <div class="variablelist"><table border="0">
839 <col align="left" valign="top">
840 <tbody>
841 <tr>
842 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
843 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
844 </td>
845 </tr>
846 <tr>
847 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
848 <td> 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
849 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. <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>
850 </td>
851 </tr>
852 </tbody>
853 </table></div>
854 </div>
855 <hr>
856 <div class="refsect2">
857 <a name="gupnp-device-info-get-service"></a><h3>gupnp_device_info_get_service ()</h3>
858 <pre class="programlisting"><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="returnvalue">GUPnPServiceInfo</span></a> *  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>,
859                                                          <em class="parameter"><code>const <span class="type">char</span> *type</code></em>);</pre>
860 <p>
861 Get the service with type <em class="parameter"><code>type</code></em> directly contained in <em class="parameter"><code>info</code></em> as a new object
862 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
863 returned object should be unreffed when done.
864 </p>
865 <p>
866 Note that services are not cached internally, so that every time you call
867 this function a new object is created. The application must cache any used
868 services if it wishes to keep them around and re-use them.
869 </p>
870 <p>
871 </p>
872 <div class="variablelist"><table border="0">
873 <col align="left" valign="top">
874 <tbody>
875 <tr>
876 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
877 <td>A <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a>
878 </td>
879 </tr>
880 <tr>
881 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
882 <td>The type of the service to be retrieved.
883 </td>
884 </tr>
885 <tr>
886 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
887 <td> A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>.
888 </td>
889 </tr>
890 </tbody>
891 </table></div>
892 </div>
893 </div>
894 <div class="refsect1">
895 <a name="GUPnPDeviceInfo.property-details"></a><h2>Property Details</h2>
896 <div class="refsect2">
897 <a name="GUPnPDeviceInfo--context"></a><h3>The <code class="literal">"context"</code> property</h3>
898 <pre class="programlisting">  "context"                  <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>*         : Read / Write / Construct Only</pre>
899 <p>
900 The <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> to use.
901 </p>
902 <p>
903 </p>
904 </div>
905 <hr>
906 <div class="refsect2">
907 <a name="GUPnPDeviceInfo--device-type"></a><h3>The <code class="literal">"device-type"</code> property</h3>
908 <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>*                : Read / Write / Construct Only</pre>
909 <p>
910 The device type.
911 </p>
912 <p>
913 </p>
914 <p>Default value: NULL</p>
915 </div>
916 <hr>
917 <div class="refsect2">
918 <a name="GUPnPDeviceInfo--document"></a><h3>The <code class="literal">"document"</code> property</h3>
919 <pre class="programlisting">  "document"                 <a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a>*          : Write / Construct Only</pre>
920 <p>
921 Private property.
922 </p>
923 <p>
924 </p>
925 <p class="stability">Stability Level: Private</p>
926 </div>
927 <hr>
928 <div class="refsect2">
929 <a name="GUPnPDeviceInfo--element"></a><h3>The <code class="literal">"element"</code> property</h3>
930 <pre class="programlisting">  "element"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only</pre>
931 <p>
932 Private property.
933 </p>
934 <p>
935 </p>
936 <p class="stability">Stability Level: Private</p>
937 </div>
938 <hr>
939 <div class="refsect2">
940 <a name="GUPnPDeviceInfo--location"></a><h3>The <code class="literal">"location"</code> property</h3>
941 <pre class="programlisting">  "location"                 <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>
942 <p>
943 The location of the device description file.
944 </p>
945 <p>
946 </p>
947 <p>Default value: NULL</p>
948 </div>
949 <hr>
950 <div class="refsect2">
951 <a name="GUPnPDeviceInfo--resource-factory"></a><h3>The <code class="literal">"resource-factory"</code> property</h3>
952 <pre class="programlisting">  "resource-factory"         <a class="link" href="GUPnPResourceFactory.html" title="GUPnPResourceFactory"><span class="type">GUPnPResourceFactory</span></a>*  : Read / Write / Construct Only</pre>
953 <p>
954 The resource factory to use. Set to NULL for default factory.
955 </p>
956 <p>
957 </p>
958 </div>
959 <hr>
960 <div class="refsect2">
961 <a name="GUPnPDeviceInfo--udn"></a><h3>The <code class="literal">"udn"</code> property</h3>
962 <pre class="programlisting">  "udn"                      <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>
963 <p>
964 The UDN of this device.
965 </p>
966 <p>
967 </p>
968 <p>Default value: NULL</p>
969 </div>
970 <hr>
971 <div class="refsect2">
972 <a name="GUPnPDeviceInfo--url-base"></a><h3>The <code class="literal">"url-base"</code> property</h3>
973 <pre class="programlisting">  "url-base"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write / Construct Only</pre>
974 <p>
975 The URL base (<span class="type">SoupURI</span>).
976 </p>
977 <p>
978 </p>
979 </div>
980 </div>
981 </div>
982 <div class="footer">
983 <hr>
984           Generated by GTK-Doc V1.15.1</div>
985 </body>
986 </html>