1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>GUPnPControlPoint</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.71.0">
7
<link rel="start" href="index.html" title="GUPnP Reference Manual">
8
<link rel="up" href="ch02.html" title="Device Control">
9
<link rel="prev" href="ch02.html" title="Device Control">
10
<link rel="next" href="gupnp-GUPnPDeviceProxy.html" title="GUPnPDeviceProxy">
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="chapter" href="ch01.html" title="Device Information">
14
<link rel="chapter" href="ch02.html" title="Device Control">
15
<link rel="chapter" href="ch03.html" title="Device Implementation">
16
<link rel="chapter" href="ch04.html" title="Tools">
18
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
19
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
21
<td><a accesskey="p" href="ch02.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
22
<td><a accesskey="u" href="ch02.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
23
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
24
<th width="100%" align="center">GUPnP Reference Manual</th>
25
<td><a accesskey="n" href="gupnp-GUPnPDeviceProxy.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
27
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2574484" class="shortcut">Top</a>
29
<a href="#id2587770" class="shortcut">Description</a></nobr></td></tr>
31
<div class="refentry" lang="en">
32
<a name="gupnp-GUPnPControlPoint"></a><div class="titlepage"></div>
33
<div class="refnamediv"><table width="100%"><tr>
36
<a name="id2574484"></a><span class="refentrytitle">GUPnPControlPoint</span>
38
<p>GUPnPControlPoint — Class for resource discovery.</p>
40
<td valign="top" align="right"></td>
42
<div class="refsynopsisdiv">
44
<pre class="synopsis">
48
<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a>;
49
<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a>* <a href="gupnp-GUPnPControlPoint.html#gupnp-control-point-new">gupnp_control_point_new</a> (<a href="gupnp-GUPnPContext.html#GUPnPContext">GUPnPContext</a> *context,
51
<a href="gupnp-GUPnPContext.html#GUPnPContext">GUPnPContext</a>* <a href="gupnp-GUPnPControlPoint.html#gupnp-control-point-get-context">gupnp_control_point_get_context</a> (<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a> *control_point);
52
const GList* <a href="gupnp-GUPnPControlPoint.html#gupnp-control-point-list-device-proxies">gupnp_control_point_list_device_proxies</a>
53
(<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a> *control_point);
54
const GList* <a href="gupnp-GUPnPControlPoint.html#gupnp-control-point-list-service-proxies">gupnp_control_point_list_service_proxies</a>
55
(<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a> *control_point);
60
<div class="refsect1" lang="en">
61
<a name="id2587770"></a><h2>Description</h2>
63
<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint"><span class="type">GUPnPControlPoint</span></a> handles device and service discovery. After creating
64
a control point and activating it using <a
65
href="../gssdp/GSSDPResourceBrowser.html#gssdp-resource-browser-set-active"
66
><code class="function">gssdp_resource_browser_set_active()</code></a>,
67
the ::device-proxy-available, ::service-proxy-available,
68
::device-proxy-unavailable and ::service-proxy-unavailable signals will
69
be emitted whenever the availability of a device or service matching
70
the specified discovery target changes.</p>
75
<div class="refsect1" lang="en">
76
<a name="id2587811"></a><h2>Details</h2>
77
<div class="refsect2" lang="en">
78
<a name="id2587822"></a><h3>
79
<a name="GUPnPControlPoint"></a>GUPnPControlPoint</h3>
80
<a class="indexterm" name="id2587834"></a><pre class="programlisting">typedef struct {
81
GSSDPResourceBrowser parent;
83
GUPnPControlPointPrivate *priv;
91
<div class="refsect2" lang="en">
92
<a name="id2585563"></a><h3>
93
<a name="gupnp-control-point-new"></a>gupnp_control_point_new ()</h3>
94
<a class="indexterm" name="id2585574"></a><pre class="programlisting"><a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a>* gupnp_control_point_new (<a href="gupnp-GUPnPContext.html#GUPnPContext">GUPnPContext</a> *context,
95
const char *target);</pre>
101
<div class="variablelist"><table border="0">
102
<col align="left" valign="top">
105
<td><span class="term"><em class="parameter"><code>context</code></em> :</span></td>
106
<td> A <a href="gupnp-GUPnPContext.html#GUPnPContext"><span class="type">GUPnPContext</span></a>
110
<td><span class="term"><em class="parameter"><code>target</code></em> :</span></td>
111
<td> The search target
115
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
116
<td> A new <a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint"><span class="type">GUPnPControlPoint</span></a> object.
123
<div class="refsect2" lang="en">
124
<a name="id2585670"></a><h3>
125
<a name="gupnp-control-point-get-context"></a>gupnp_control_point_get_context ()</h3>
126
<a class="indexterm" name="id2585681"></a><pre class="programlisting"><a href="gupnp-GUPnPContext.html#GUPnPContext">GUPnPContext</a>* gupnp_control_point_get_context (<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a> *control_point);</pre>
132
<div class="variablelist"><table border="0">
133
<col align="left" valign="top">
136
<td><span class="term"><em class="parameter"><code>control_point</code></em> :</span></td>
137
<td> A <a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint"><span class="type">GUPnPControlPoint</span></a>
141
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
142
<td> The <a href="gupnp-GUPnPContext.html#GUPnPContext"><span class="type">GUPnPContext</span></a> associated with <em class="parameter"><code>control_point</code></em>.
149
<div class="refsect2" lang="en">
150
<a name="id2592063"></a><h3>
151
<a name="gupnp-control-point-list-device-proxies"></a>gupnp_control_point_list_device_proxies ()</h3>
152
<a class="indexterm" name="id2592075"></a><pre class="programlisting">const GList* gupnp_control_point_list_device_proxies
153
(<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a> *control_point);</pre>
159
<div class="variablelist"><table border="0">
160
<col align="left" valign="top">
163
<td><span class="term"><em class="parameter"><code>control_point</code></em> :</span></td>
164
<td> A <a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint"><span class="type">GUPnPControlPoint</span></a>
168
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
169
<td> A <span class="type">GList</span> of discovered <a href="gupnp-GUPnPDeviceProxy.html#GUPnPDeviceProxy"><span class="type">GUPnPDeviceProxy</span></a> objects. Do not
170
free the list nor its elements.
177
<div class="refsect2" lang="en">
178
<a name="id2592161"></a><h3>
179
<a name="gupnp-control-point-list-service-proxies"></a>gupnp_control_point_list_service_proxies ()</h3>
180
<a class="indexterm" name="id2592174"></a><pre class="programlisting">const GList* gupnp_control_point_list_service_proxies
181
(<a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint">GUPnPControlPoint</a> *control_point);</pre>
187
<div class="variablelist"><table border="0">
188
<col align="left" valign="top">
191
<td><span class="term"><em class="parameter"><code>control_point</code></em> :</span></td>
192
<td> A <a href="gupnp-GUPnPControlPoint.html#GUPnPControlPoint"><span class="type">GUPnPControlPoint</span></a>
196
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
197
<td> A <span class="type">GList</span> of discovered <a href="gupnp-GUPnPServiceProxy.html#GUPnPServiceProxy"><span class="type">GUPnPServiceProxy</span></a> objects. Do not
198
free the list nor its elements.