1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GUPnPDLNAInformation</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GUPnP DLNA Reference Manual">
8 <link rel="up" href="ch01.html" title="GUPnP DLNA">
9 <link rel="prev" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile">
10 <link rel="next" href="gupnp-dlna-GUPnP-DLNA-Values.html" title="GUPnP DLNA Values">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="GUPnPDLNAProfile.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="ch01.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 DLNA Reference Manual</th>
21 <td><a accesskey="n" href="gupnp-dlna-GUPnP-DLNA-Values.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GUPnPDLNAInformation.synopsis" class="shortcut">Top</a>
26 <a href="#GUPnPDLNAInformation.description" class="shortcut">Description</a>
28 <a href="#GUPnPDLNAInformation.object-hierarchy" class="shortcut">Object Hierarchy</a>
30 <a href="#GUPnPDLNAInformation.properties" class="shortcut">Properties</a>
33 <div class="refentry">
34 <a name="GUPnPDLNAInformation"></a><div class="titlepage"></div>
35 <div class="refnamediv"><table width="100%"><tr>
37 <h2><span class="refentrytitle"><a name="GUPnPDLNAInformation.top_of_page"></a>GUPnPDLNAInformation</span></h2>
38 <p>GUPnPDLNAInformation — Base class for storing various types of
39 metadata informations.</p>
41 <td valign="top" align="right"></td>
43 <div class="refsynopsisdiv">
44 <a name="GUPnPDLNAInformation.synopsis"></a><h2>Synopsis</h2>
45 <pre class="synopsis"> <a class="link" href="GUPnPDLNAInformation.html#GUPnPDLNAInformation-struct" title="GUPnPDLNAInformation">GUPnPDLNAInformation</a>;
46 <a class="link" href="GUPnPDLNAInformation.html#GUPnPDLNAInformationClass" title="GUPnPDLNAInformationClass">GUPnPDLNAInformationClass</a>;
47 <a class="link" href="GUPnPDLNAAudioInformation.html" title="GUPnPDLNAAudioInformation"><span class="returnvalue">GUPnPDLNAAudioInformation</span></a> * <a class="link" href="GUPnPDLNAInformation.html#gupnp-dlna-information-get-audio-information" title="gupnp_dlna_information_get_audio_information ()">gupnp_dlna_information_get_audio_information</a>
48 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);
49 <a class="link" href="GUPnPDLNAContainerInformation.html" title="GUPnPDLNAContainerInformation"><span class="returnvalue">GUPnPDLNAContainerInformation</span></a> * <a class="link" href="GUPnPDLNAInformation.html#gupnp-dlna-information-get-container-information" title="gupnp_dlna_information_get_container_information ()">gupnp_dlna_information_get_container_information</a>
50 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);
51 <a class="link" href="GUPnPDLNAImageInformation.html" title="GUPnPDLNAImageInformation"><span class="returnvalue">GUPnPDLNAImageInformation</span></a> * <a class="link" href="GUPnPDLNAInformation.html#gupnp-dlna-information-get-image-information" title="gupnp_dlna_information_get_image_information ()">gupnp_dlna_information_get_image_information</a>
52 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);
53 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GUPnPDLNAInformation.html#gupnp-dlna-information-get-profile-name" title="gupnp_dlna_information_get_profile_name ()">gupnp_dlna_information_get_profile_name</a>
54 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);
55 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GUPnPDLNAInformation.html#gupnp-dlna-information-get-uri" title="gupnp_dlna_information_get_uri ()">gupnp_dlna_information_get_uri</a> (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);
56 <a class="link" href="GUPnPDLNAVideoInformation.html" title="GUPnPDLNAVideoInformation"><span class="returnvalue">GUPnPDLNAVideoInformation</span></a> * <a class="link" href="GUPnPDLNAInformation.html#gupnp-dlna-information-get-video-information" title="gupnp_dlna_information_get_video_information ()">gupnp_dlna_information_get_video_information</a>
57 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);
60 <div class="refsect1">
61 <a name="GUPnPDLNAInformation.object-hierarchy"></a><h2>Object Hierarchy</h2>
62 <pre class="synopsis">
63 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
64 +----GUPnPDLNAInformation
67 <div class="refsect1">
68 <a name="GUPnPDLNAInformation.properties"></a><h2>Properties</h2>
69 <pre class="synopsis">
70 "<a class="link" href="GUPnPDLNAInformation.html#GUPnPDLNAInformation--audio-information" title='The "audio-information" property'>audio-information</a>" <a class="link" href="GUPnPDLNAAudioInformation.html" title="GUPnPDLNAAudioInformation"><span class="type">GUPnPDLNAAudioInformation</span></a>* : Read
71 "<a class="link" href="GUPnPDLNAInformation.html#GUPnPDLNAInformation--container-information" title='The "container-information" property'>container-information</a>" <a class="link" href="GUPnPDLNAContainerInformation.html" title="GUPnPDLNAContainerInformation"><span class="type">GUPnPDLNAContainerInformation</span></a>* : Read
72 "<a class="link" href="GUPnPDLNAInformation.html#GUPnPDLNAInformation--image-information" title='The "image-information" property'>image-information</a>" <a class="link" href="GUPnPDLNAImageInformation.html" title="GUPnPDLNAImageInformation"><span class="type">GUPnPDLNAImageInformation</span></a>* : Read
73 "<a class="link" href="GUPnPDLNAInformation.html#GUPnPDLNAInformation--uri" title='The "uri" property'>uri</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
74 "<a class="link" href="GUPnPDLNAInformation.html#GUPnPDLNAInformation--video-information" title='The "video-information" property'>video-information</a>" <a class="link" href="GUPnPDLNAVideoInformation.html" title="GUPnPDLNAVideoInformation"><span class="type">GUPnPDLNAVideoInformation</span></a>* : Read
77 <div class="refsect1">
78 <a name="GUPnPDLNAInformation.description"></a><h2>Description</h2>
80 Subclasses of <a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> should override all virtual
81 functions provided by this class. The overrides should return a
82 subclasses of specific information base classes.
85 When instantiating a subclass of <a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> make sure
86 that "uri" with a URI to media file is passed to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-new"><code class="function">g_object_new()</code></a>.
89 <div class="refsect1">
90 <a name="GUPnPDLNAInformation.details"></a><h2>Details</h2>
91 <div class="refsect2">
92 <a name="GUPnPDLNAInformation-struct"></a><h3>GUPnPDLNAInformation</h3>
93 <pre class="programlisting">typedef struct _GUPnPDLNAInformation GUPnPDLNAInformation;</pre>
96 <div class="refsect2">
97 <a name="GUPnPDLNAInformationClass"></a><h3>GUPnPDLNAInformationClass</h3>
98 <pre class="programlisting">typedef struct {
99 GObjectClass parent_class;
101 GUPnPDLNAAudioInformation *
102 (* get_audio_information) (GUPnPDLNAInformation *info);
104 GUPnPDLNAContainerInformation *
105 (* get_container_information) (GUPnPDLNAInformation *info);
107 GUPnPDLNAImageInformation *
108 (* get_image_information) (GUPnPDLNAInformation *info);
110 GUPnPDLNAVideoInformation *
111 (* get_video_information) (GUPnPDLNAInformation *info);
114 (* get_profile_name) (GUPnPDLNAInformation *info);
116 gpointer _reserved[11];
117 } GUPnPDLNAInformationClass;
119 <div class="variablelist"><table border="0">
120 <col align="left" valign="top">
123 <td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="GUPnPDLNAInformationClass.parent-class"></a>parent_class</code></em>;</span></p></td>
124 <td>Parent class.</td>
127 <td><p><span class="term"><em class="structfield"><code><a name="GUPnPDLNAInformationClass.get-audio-information"></a>get_audio_information</code></em> ()</span></p></td>
128 <td>This is called by <a class="link" href="GUPnPDLNAProfileGuesser.html" title="GUPnPDLNAProfileGuesser"><span class="type">GUPnPDLNAProfileGuesser</span></a>
129 to get an audio information.</td>
132 <td><p><span class="term"><em class="structfield"><code><a name="GUPnPDLNAInformationClass.get-container-information"></a>get_container_information</code></em> ()</span></p></td>
133 <td>This is called by
134 <a class="link" href="GUPnPDLNAProfileGuesser.html" title="GUPnPDLNAProfileGuesser"><span class="type">GUPnPDLNAProfileGuesser</span></a> to get a container information.</td>
137 <td><p><span class="term"><em class="structfield"><code><a name="GUPnPDLNAInformationClass.get-image-information"></a>get_image_information</code></em> ()</span></p></td>
138 <td>This is called by <a class="link" href="GUPnPDLNAProfileGuesser.html" title="GUPnPDLNAProfileGuesser"><span class="type">GUPnPDLNAProfileGuesser</span></a>
139 to get an image information.</td>
142 <td><p><span class="term"><em class="structfield"><code><a name="GUPnPDLNAInformationClass.get-video-information"></a>get_video_information</code></em> ()</span></p></td>
143 <td>This is called by <a class="link" href="GUPnPDLNAProfileGuesser.html" title="GUPnPDLNAProfileGuesser"><span class="type">GUPnPDLNAProfileGuesser</span></a>
144 to get a video information.</td>
147 <td><p><span class="term"><em class="structfield"><code><a name="GUPnPDLNAInformationClass.get-profile-name"></a>get_profile_name</code></em> ()</span></p></td>
148 <td>This is called by <a class="link" href="GUPnPDLNAProfileGuesser.html" title="GUPnPDLNAProfileGuesser"><span class="type">GUPnPDLNAProfileGuesser</span></a> to
149 get the name of the DLNA profile assigned with this information.</td>
152 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="GUPnPDLNAInformationClass.-reserved"></a>_reserved</code></em>[11];</span></p></td>
153 <td>Padding. Ignore it.</td>
159 <div class="refsect2">
160 <a name="gupnp-dlna-information-get-audio-information"></a><h3>gupnp_dlna_information_get_audio_information ()</h3>
161 <pre class="programlisting"><a class="link" href="GUPnPDLNAAudioInformation.html" title="GUPnPDLNAAudioInformation"><span class="returnvalue">GUPnPDLNAAudioInformation</span></a> * gupnp_dlna_information_get_audio_information
162 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);</pre>
164 Get an audio information of media file if applicable (e.g. for
165 video and audio files).
167 <div class="variablelist"><table border="0">
168 <col align="left" valign="top">
171 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
172 <td>A <a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> object.</td>
175 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
176 <td>A <a class="link" href="GUPnPDLNAAudioInformation.html" title="GUPnPDLNAAudioInformation"><span class="type">GUPnPDLNAAudioInformation</span></a> object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
183 <div class="refsect2">
184 <a name="gupnp-dlna-information-get-container-information"></a><h3>gupnp_dlna_information_get_container_information ()</h3>
185 <pre class="programlisting"><a class="link" href="GUPnPDLNAContainerInformation.html" title="GUPnPDLNAContainerInformation"><span class="returnvalue">GUPnPDLNAContainerInformation</span></a> * gupnp_dlna_information_get_container_information
186 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);</pre>
188 Get an container information of media file if applicable (e.g. for
189 video and audio files).
191 <div class="variablelist"><table border="0">
192 <col align="left" valign="top">
195 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
196 <td>A <a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> object.</td>
199 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
200 <td>A <a class="link" href="GUPnPDLNAContainerInformation.html" title="GUPnPDLNAContainerInformation"><span class="type">GUPnPDLNAContainerInformation</span></a> object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
207 <div class="refsect2">
208 <a name="gupnp-dlna-information-get-image-information"></a><h3>gupnp_dlna_information_get_image_information ()</h3>
209 <pre class="programlisting"><a class="link" href="GUPnPDLNAImageInformation.html" title="GUPnPDLNAImageInformation"><span class="returnvalue">GUPnPDLNAImageInformation</span></a> * gupnp_dlna_information_get_image_information
210 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);</pre>
212 Get an container information of media file if applicable (e.g. for
215 <div class="variablelist"><table border="0">
216 <col align="left" valign="top">
219 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
220 <td>A <a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> object.</td>
223 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
224 <td>A <a class="link" href="GUPnPDLNAImageInformation.html" title="GUPnPDLNAImageInformation"><span class="type">GUPnPDLNAImageInformation</span></a> object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
231 <div class="refsect2">
232 <a name="gupnp-dlna-information-get-profile-name"></a><h3>gupnp_dlna_information_get_profile_name ()</h3>
233 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gupnp_dlna_information_get_profile_name
234 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);</pre>
235 <div class="variablelist"><table border="0">
236 <col align="left" valign="top">
239 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
240 <td>A <a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> object.</td>
243 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
244 <td>The name of a DLNA profile or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
251 <div class="refsect2">
252 <a name="gupnp-dlna-information-get-uri"></a><h3>gupnp_dlna_information_get_uri ()</h3>
253 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gupnp_dlna_information_get_uri (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);</pre>
254 <div class="variablelist"><table border="0">
255 <col align="left" valign="top">
258 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
259 <td>A <a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> object.</td>
262 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
263 <td>An URI of a file. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
270 <div class="refsect2">
271 <a name="gupnp-dlna-information-get-video-information"></a><h3>gupnp_dlna_information_get_video_information ()</h3>
272 <pre class="programlisting"><a class="link" href="GUPnPDLNAVideoInformation.html" title="GUPnPDLNAVideoInformation"><span class="returnvalue">GUPnPDLNAVideoInformation</span></a> * gupnp_dlna_information_get_video_information
273 (<em class="parameter"><code><a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> *info</code></em>);</pre>
275 Get an container information of media file if applicable (e.g. for
278 <div class="variablelist"><table border="0">
279 <col align="left" valign="top">
282 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
283 <td>A <a class="link" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation"><span class="type">GUPnPDLNAInformation</span></a> object.</td>
286 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
287 <td>A <a class="link" href="GUPnPDLNAVideoInformation.html" title="GUPnPDLNAVideoInformation"><span class="type">GUPnPDLNAVideoInformation</span></a> object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
294 <div class="refsect1">
295 <a name="GUPnPDLNAInformation.property-details"></a><h2>Property Details</h2>
296 <div class="refsect2">
297 <a name="GUPnPDLNAInformation--audio-information"></a><h3>The <code class="literal">"audio-information"</code> property</h3>
298 <pre class="programlisting"> "audio-information" <a class="link" href="GUPnPDLNAAudioInformation.html" title="GUPnPDLNAAudioInformation"><span class="type">GUPnPDLNAAudioInformation</span></a>* : Read</pre>
300 Audio information of a file.
304 <div class="refsect2">
305 <a name="GUPnPDLNAInformation--container-information"></a><h3>The <code class="literal">"container-information"</code> property</h3>
306 <pre class="programlisting"> "container-information" <a class="link" href="GUPnPDLNAContainerInformation.html" title="GUPnPDLNAContainerInformation"><span class="type">GUPnPDLNAContainerInformation</span></a>* : Read</pre>
308 Container information of a file.
312 <div class="refsect2">
313 <a name="GUPnPDLNAInformation--image-information"></a><h3>The <code class="literal">"image-information"</code> property</h3>
314 <pre class="programlisting"> "image-information" <a class="link" href="GUPnPDLNAImageInformation.html" title="GUPnPDLNAImageInformation"><span class="type">GUPnPDLNAImageInformation</span></a>* : Read</pre>
316 Image information of a file.
320 <div class="refsect2">
321 <a name="GUPnPDLNAInformation--uri"></a><h3>The <code class="literal">"uri"</code> property</h3>
322 <pre class="programlisting"> "uri" <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>
324 URI of file which metadata this object stores.
326 <p>Default value: NULL</p>
329 <div class="refsect2">
330 <a name="GUPnPDLNAInformation--video-information"></a><h3>The <code class="literal">"video-information"</code> property</h3>
331 <pre class="programlisting"> "video-information" <a class="link" href="GUPnPDLNAVideoInformation.html" title="GUPnPDLNAVideoInformation"><span class="type">GUPnPDLNAVideoInformation</span></a>* : Read</pre>
333 Video information of a file.
340 Generated by GTK-Doc V1.18</div>