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>GUPnPDLNAProfile</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="GUPnPDLNAProfileGuesser.html" title="GUPnPDLNAProfileGuesser">
10 <link rel="next" href="GUPnPDLNAInformation.html" title="GUPnPDLNAInformation">
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="GUPnPDLNAProfileGuesser.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="GUPnPDLNAInformation.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="#GUPnPDLNAProfile.synopsis" class="shortcut">Top</a>
26 <a href="#GUPnPDLNAProfile.description" class="shortcut">Description</a>
28 <a href="#GUPnPDLNAProfile.object-hierarchy" class="shortcut">Object Hierarchy</a>
30 <a href="#GUPnPDLNAProfile.properties" class="shortcut">Properties</a>
33 <div class="refentry">
34 <a name="GUPnPDLNAProfile"></a><div class="titlepage"></div>
35 <div class="refnamediv"><table width="100%"><tr>
37 <h2><span class="refentrytitle"><a name="GUPnPDLNAProfile.top_of_page"></a>GUPnPDLNAProfile</span></h2>
38 <p>GUPnPDLNAProfile — Object representing a DLNA profile</p>
40 <td valign="top" align="right"></td>
42 <div class="refsynopsisdiv">
43 <a name="GUPnPDLNAProfile.synopsis"></a><h2>Synopsis</h2>
44 <pre class="synopsis"> <a class="link" href="GUPnPDLNAProfile.html#GUPnPDLNAProfile-struct" title="GUPnPDLNAProfile">GUPnPDLNAProfile</a>;
45 <a class="link" href="GUPnPDLNAProfile.html#GUPnPDLNAProfileClass" title="GUPnPDLNAProfileClass">GUPnPDLNAProfileClass</a>;
46 <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="GUPnPDLNAProfile.html#gupnp-dlna-profile-get-audio-restrictions" title="gupnp_dlna_profile_get_audio_restrictions ()">gupnp_dlna_profile_get_audio_restrictions</a>
47 (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);
48 <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="GUPnPDLNAProfile.html#gupnp-dlna-profile-get-container-restrictions" title="gupnp_dlna_profile_get_container_restrictions ()">gupnp_dlna_profile_get_container_restrictions</a>
49 (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);
50 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GUPnPDLNAProfile.html#gupnp-dlna-profile-get-extended" title="gupnp_dlna_profile_get_extended ()">gupnp_dlna_profile_get_extended</a> (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);
51 <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="GUPnPDLNAProfile.html#gupnp-dlna-profile-get-image-restrictions" title="gupnp_dlna_profile_get_image_restrictions ()">gupnp_dlna_profile_get_image_restrictions</a>
52 (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</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="GUPnPDLNAProfile.html#gupnp-dlna-profile-get-mime" title="gupnp_dlna_profile_get_mime ()">gupnp_dlna_profile_get_mime</a> (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);
54 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="GUPnPDLNAProfile.html#gupnp-dlna-profile-get-name" title="gupnp_dlna_profile_get_name ()">gupnp_dlna_profile_get_name</a> (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);
55 <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="GUPnPDLNAProfile.html#gupnp-dlna-profile-get-video-restrictions" title="gupnp_dlna_profile_get_video_restrictions ()">gupnp_dlna_profile_get_video_restrictions</a>
56 (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);
59 <div class="refsect1">
60 <a name="GUPnPDLNAProfile.object-hierarchy"></a><h2>Object Hierarchy</h2>
61 <pre class="synopsis">
62 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
66 <div class="refsect1">
67 <a name="GUPnPDLNAProfile.properties"></a><h2>Properties</h2>
68 <pre class="synopsis">
69 "<a class="link" href="GUPnPDLNAProfile.html#GUPnPDLNAProfile--audio-restrictions" title='The "audio-restrictions" property'>audio-restrictions</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
70 "<a class="link" href="GUPnPDLNAProfile.html#GUPnPDLNAProfile--container-restrictions" title='The "container-restrictions" property'>container-restrictions</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
71 "<a class="link" href="GUPnPDLNAProfile.html#GUPnPDLNAProfile--extended" title='The "extended" property'>extended</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct Only
72 "<a class="link" href="GUPnPDLNAProfile.html#GUPnPDLNAProfile--image-restrictions" title='The "image-restrictions" property'>image-restrictions</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
73 "<a class="link" href="GUPnPDLNAProfile.html#GUPnPDLNAProfile--mime" title='The "mime" property'>mime</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="GUPnPDLNAProfile.html#GUPnPDLNAProfile--name" title='The "name" property'>name</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
75 "<a class="link" href="GUPnPDLNAProfile.html#GUPnPDLNAProfile--video-restrictions" title='The "video-restrictions" property'>video-restrictions</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
78 <div class="refsect1">
79 <a name="GUPnPDLNAProfile.description"></a><h2>Description</h2>
81 The <a class="link" href="GUPnPDLNAProfileGuesser.html" title="GUPnPDLNAProfileGuesser"><span class="type">GUPnPDLNAProfileGuesser</span></a> object provides a few APIs that return
82 <a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> objects. These represent a single DLNA
83 profile. Each <a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> has a name (the name of the DLNA
84 profile) and the corresponding MIME type.
87 Public representation of the various audio/container/image/video
88 restrictions specified for that DLNA profile is to be added.
91 <div class="refsect1">
92 <a name="GUPnPDLNAProfile.details"></a><h2>Details</h2>
93 <div class="refsect2">
94 <a name="GUPnPDLNAProfile-struct"></a><h3>GUPnPDLNAProfile</h3>
95 <pre class="programlisting">typedef struct _GUPnPDLNAProfile GUPnPDLNAProfile;</pre>
97 The top-level object used for the in-memory representation of the
102 <div class="refsect2">
103 <a name="GUPnPDLNAProfileClass"></a><h3>GUPnPDLNAProfileClass</h3>
104 <pre class="programlisting">typedef struct {
105 GObjectClass parent_class;
106 } GUPnPDLNAProfileClass;
108 <div class="variablelist"><table border="0">
109 <col align="left" valign="top">
111 <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="GUPnPDLNAProfileClass.parent-class"></a>parent_class</code></em>;</span></p></td>
112 <td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> - parent of this class.</td>
117 <div class="refsect2">
118 <a name="gupnp-dlna-profile-get-audio-restrictions"></a><h3>gupnp_dlna_profile_get_audio_restrictions ()</h3>
119 <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_dlna_profile_get_audio_restrictions
120 (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);</pre>
122 Gets a list of audio restrictions.
124 <div class="variablelist"><table border="0">
125 <col align="left" valign="top">
128 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
129 <td>A profile. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
133 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
135 restrictions. Do not modify. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GUPnPDLNARestriction]</span>
142 <div class="refsect2">
143 <a name="gupnp-dlna-profile-get-container-restrictions"></a><h3>gupnp_dlna_profile_get_container_restrictions ()</h3>
144 <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_dlna_profile_get_container_restrictions
145 (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);</pre>
147 Gets a list of container restrictions.
149 <div class="variablelist"><table border="0">
150 <col align="left" valign="top">
153 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
154 <td>A profile. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
158 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
159 <td>Container restrictions. Do not modify. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GUPnPDLNARestriction]</span>
166 <div class="refsect2">
167 <a name="gupnp-dlna-profile-get-extended"></a><h3>gupnp_dlna_profile_get_extended ()</h3>
168 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gupnp_dlna_profile_get_extended (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);</pre>
169 <div class="variablelist"><table border="0">
170 <col align="left" valign="top">
173 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
174 <td>The <a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> object.</td>
177 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
179 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>profile</code></em> is extended one and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
185 <div class="refsect2">
186 <a name="gupnp-dlna-profile-get-image-restrictions"></a><h3>gupnp_dlna_profile_get_image_restrictions ()</h3>
187 <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_dlna_profile_get_image_restrictions
188 (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);</pre>
190 Gets a list of image restrictions.
192 <div class="variablelist"><table border="0">
193 <col align="left" valign="top">
196 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
197 <td>A profile. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
201 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
203 restrictions. Do not modify. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GUPnPDLNARestriction]</span>
210 <div class="refsect2">
211 <a name="gupnp-dlna-profile-get-mime"></a><h3>gupnp_dlna_profile_get_mime ()</h3>
212 <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_profile_get_mime (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);</pre>
213 <div class="variablelist"><table border="0">
214 <col align="left" valign="top">
217 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
218 <td>The <a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> object.</td>
221 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
222 <td>The DLNA MIME type of the DLNA profile represented by <em class="parameter"><code>profile</code></em>.</td>
228 <div class="refsect2">
229 <a name="gupnp-dlna-profile-get-name"></a><h3>gupnp_dlna_profile_get_name ()</h3>
230 <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_profile_get_name (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);</pre>
231 <div class="variablelist"><table border="0">
232 <col align="left" valign="top">
235 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
236 <td>The <a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> object.</td>
239 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
240 <td>The name of the DLNA profile represented by <em class="parameter"><code>profile</code></em>.</td>
246 <div class="refsect2">
247 <a name="gupnp-dlna-profile-get-video-restrictions"></a><h3>gupnp_dlna_profile_get_video_restrictions ()</h3>
248 <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_dlna_profile_get_video_restrictions
249 (<em class="parameter"><code><a class="link" href="GUPnPDLNAProfile.html" title="GUPnPDLNAProfile"><span class="type">GUPnPDLNAProfile</span></a> *profile</code></em>);</pre>
251 Gets a list of video restrictions.
253 <div class="variablelist"><table border="0">
254 <col align="left" valign="top">
257 <td><p><span class="term"><em class="parameter"><code>profile</code></em> :</span></p></td>
258 <td>A profile. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
262 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
264 restrictions. Do not modify. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GUPnPDLNARestriction]</span>
271 <div class="refsect1">
272 <a name="GUPnPDLNAProfile.property-details"></a><h2>Property Details</h2>
273 <div class="refsect2">
274 <a name="GUPnPDLNAProfile--audio-restrictions"></a><h3>The <code class="literal">"audio-restrictions"</code> property</h3>
275 <pre class="programlisting"> "audio-restrictions" <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>
276 <p>Audio restrictions for the DLNA Profile.</p>
279 <div class="refsect2">
280 <a name="GUPnPDLNAProfile--container-restrictions"></a><h3>The <code class="literal">"container-restrictions"</code> property</h3>
281 <pre class="programlisting"> "container-restrictions" <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>
282 <p>Container restrictions for the DLNA Profile.</p>
285 <div class="refsect2">
286 <a name="GUPnPDLNAProfile--extended"></a><h3>The <code class="literal">"extended"</code> property</h3>
287 <pre class="programlisting"> "extended" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write / Construct Only</pre>
289 Whether the DLNA profile is not a part of DLNA specification.
291 <p>Default value: FALSE</p>
294 <div class="refsect2">
295 <a name="GUPnPDLNAProfile--image-restrictions"></a><h3>The <code class="literal">"image-restrictions"</code> property</h3>
296 <pre class="programlisting"> "image-restrictions" <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>
297 <p>Image restrictions for the DLNA Profile.</p>
300 <div class="refsect2">
301 <a name="GUPnPDLNAProfile--mime"></a><h3>The <code class="literal">"mime"</code> property</h3>
302 <pre class="programlisting"> "mime" <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>
304 MIME type of the DLNA profile.
306 <p>Default value: NULL</p>
309 <div class="refsect2">
310 <a name="GUPnPDLNAProfile--name"></a><h3>The <code class="literal">"name"</code> property</h3>
311 <pre class="programlisting"> "name" <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>
313 Name of the DLNA profile.
315 <p>Default value: NULL</p>
318 <div class="refsect2">
319 <a name="GUPnPDLNAProfile--video-restrictions"></a><h3>The <code class="literal">"video-restrictions"</code> property</h3>
320 <pre class="programlisting"> "video-restrictions" <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>
321 <p>Video restrictions for the DLNA Profile.</p>
327 Generated by GTK-Doc V1.18</div>