← Back to branch summary

~ubuntu-branches/debian/experimental/gupnp/experimental

« back to all changes in this revision

Viewing changes to doc/xml/gupnp-control-point.xml

  • Committer: Bazaar Package Importer
  • Author(s): Ross Burton
  • Date: 2008-06-30 09:32:18 UTC
  • mfrom: (1.2.1 upstream) (2.1.5 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080630093218-vmb4elru8cn18579
Tags: 0.12.1-1
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/xml/gupnp-control-point.xml
1
1
<?xml version="1.0"?>
2
 
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
3
 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
 
<!ENTITY version SYSTEM "version.xml">               
5
 
]>
6
 
<refentry id="gupnp-GUPnPControlPoint">
 
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
 
3
<refentry id="GUPnPControlPoint">
7
4
<refmeta>
8
 
<refentrytitle role="top_of_page">GUPnPControlPoint</refentrytitle>
 
5
<refentrytitle role="top_of_page" id="GUPnPControlPoint.top_of_page">GUPnPControlPoint</refentrytitle>
9
6
<manvolnum>3</manvolnum>
10
7
<refmiscinfo>GUPNP Library</refmiscinfo>
11
8
</refmeta>
16
13
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
17
14
</refnamediv>
18
15
 
19
 
<refsynopsisdiv role="synopsis">
 
16
<refsynopsisdiv id="GUPnPControlPoint.synopsis" role="synopsis">
20
17
<title role="synopsis.title">Synopsis</title>
21
18
 
22
19
<synopsis>
23
 
 
24
 
 
25
 
 
26
 
                    <link linkend="GUPnPControlPoint">GUPnPControlPoint</link>;
 
20
                    <link linkend="GUPnPControlPoint-struct">GUPnPControlPoint</link>;
27
21
<link linkend="GUPnPControlPoint">GUPnPControlPoint</link>*  <link linkend="gupnp-control-point-new">gupnp_control_point_new</link>             (<link linkend="GUPnPContext">GUPnPContext</link> *context,
28
22
                                                         const <link linkend="char">char</link> *target);
 
23
<link linkend="GUPnPControlPoint">GUPnPControlPoint</link>*  <link linkend="gupnp-control-point-new-full">gupnp_control_point_new_full</link>        (<link linkend="GUPnPContext">GUPnPContext</link> *context,
 
24
                                                         <link linkend="GUPnPResourceFactory">GUPnPResourceFactory</link> *factory,
 
25
                                                         const <link linkend="char">char</link> *target);
 
26
<link linkend="GUPnPResourceFactory">GUPnPResourceFactory</link>* <link linkend="gupnp-control-point-get-resource-factory">gupnp_control_point_get_resource_factory</link>
 
27
                                                        (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);
29
28
<link linkend="GUPnPContext">GUPnPContext</link>*       <link linkend="gupnp-control-point-get-context">gupnp_control_point_get_context</link>     (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);
30
29
const <link linkend="GList">GList</link>*        <link linkend="gupnp-control-point-list-device-proxies">gupnp_control_point_list_device_proxies</link>
31
30
                                                        (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);
32
31
const <link linkend="GList">GList</link>*        <link linkend="gupnp-control-point-list-service-proxies">gupnp_control_point_list_service_proxies</link>
33
32
                                                        (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);
34
 
 
35
 
 
36
33
</synopsis>
37
34
</refsynopsisdiv>
38
35
 
39
 
 
40
 
 
41
 
 
42
 
 
43
 
 
44
 
 
45
 
 
46
 
 
47
 
<refsect1 role="desc">
 
36
<refsect1 id="GUPnPControlPoint.object-hierarchy" role="object_hierarchy">
 
37
<title role="object_hierarchy.title">Object Hierarchy</title>
 
38
<synopsis>
 
39
  <link linkend="GObject">GObject</link>
 
40
   +----<link linkend="GSSDPResourceBrowser">GSSDPResourceBrowser</link>
 
41
         +----GUPnPControlPoint
 
42
</synopsis>
 
43
 
 
44
</refsect1>
 
45
 
 
46
 
 
47
 
 
48
 
 
49
 
 
50
<refsect1 id="GUPnPControlPoint.properties" role="properties">
 
51
<title role="properties.title">Properties</title>
 
52
<synopsis>
 
53
  &quot;<link linkend="GUPnPControlPoint--resource-factory">resource-factory</link>&quot;         <link linkend="GUPnPResourceFactory">GUPnPResourceFactory</link>*  : Read / Write / Construct Only
 
54
</synopsis>
 
55
</refsect1>
 
56
 
 
57
<refsect1 id="GUPnPControlPoint.signals" role="signal_proto">
 
58
<title role="signal_proto.title">Signals</title>
 
59
<synopsis>
 
60
  &quot;<link linkend="GUPnPControlPoint-device-proxy-available">device-proxy-available</link>&quot;                         : Run Last
 
61
  &quot;<link linkend="GUPnPControlPoint-device-proxy-unavailable">device-proxy-unavailable</link>&quot;                       : Run Last
 
62
  &quot;<link linkend="GUPnPControlPoint-service-proxy-available">service-proxy-available</link>&quot;                        : Run Last
 
63
  &quot;<link linkend="GUPnPControlPoint-service-proxy-unavailable">service-proxy-unavailable</link>&quot;                      : Run Last
 
64
</synopsis>
 
65
</refsect1>
 
66
 
 
67
 
 
68
<refsect1 id="GUPnPControlPoint.description" role="desc">
48
69
<title role="desc.title">Description</title>
49
70
<para>
50
71
<link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> handles device and service discovery. After creating
58
79
</para>
59
80
</refsect1>
60
81
 
61
 
<refsect1 role="details">
 
82
<refsect1 id="GUPnPControlPoint.details" role="details">
62
83
<title role="details.title">Details</title>
63
 
<refsect2>
64
 
<title><anchor id="GUPnPControlPoint" role="struct"/>GUPnPControlPoint</title>
65
 
<indexterm><primary>GUPnPControlPoint</primary></indexterm><programlisting>typedef struct {
66
 
        GSSDPResourceBrowser parent;
67
 
 
68
 
        GUPnPControlPointPrivate *priv;
69
 
} GUPnPControlPoint;
70
 
</programlisting>
71
 
<para>
72
 
 
73
 
</para></refsect2>
74
 
<refsect2>
75
 
<title><anchor id="gupnp-control-point-new" role="function"/>gupnp_control_point_new ()</title>
76
 
<indexterm><primary>gupnp_control_point_new</primary></indexterm><programlisting><link linkend="GUPnPControlPoint">GUPnPControlPoint</link>*  gupnp_control_point_new             (<link linkend="GUPnPContext">GUPnPContext</link> *context,
77
 
                                                         const <link linkend="char">char</link> *target);</programlisting>
78
 
<para>
79
 
</para>
80
 
<para>
81
 
 
82
 
</para><variablelist role="params">
83
 
<varlistentry><term><parameter>context</parameter>&nbsp;:</term>
84
 
<listitem><simpara> A <link linkend="GUPnPContext"><type>GUPnPContext</type></link>
85
 
</simpara></listitem></varlistentry>
86
 
<varlistentry><term><parameter>target</parameter>&nbsp;:</term>
87
 
<listitem><simpara> The search target
88
 
</simpara></listitem></varlistentry>
89
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A new <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> object.
90
 
</simpara></listitem></varlistentry>
91
 
</variablelist></refsect2>
92
 
<refsect2>
93
 
<title><anchor id="gupnp-control-point-get-context" role="function"/>gupnp_control_point_get_context ()</title>
94
 
<indexterm><primary>gupnp_control_point_get_context</primary></indexterm><programlisting><link linkend="GUPnPContext">GUPnPContext</link>*       gupnp_control_point_get_context     (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);</programlisting>
95
 
<para>
96
 
</para>
97
 
<para>
98
 
 
99
 
</para><variablelist role="params">
100
 
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
101
 
<listitem><simpara> A <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link>
102
 
</simpara></listitem></varlistentry>
103
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The <link linkend="GUPnPContext"><type>GUPnPContext</type></link> associated with <parameter>control_point</parameter>.
104
 
</simpara></listitem></varlistentry>
105
 
</variablelist></refsect2>
106
 
<refsect2>
107
 
<title><anchor id="gupnp-control-point-list-device-proxies" role="function"/>gupnp_control_point_list_device_proxies ()</title>
108
 
<indexterm><primary>gupnp_control_point_list_device_proxies</primary></indexterm><programlisting>const <link linkend="GList">GList</link>*        gupnp_control_point_list_device_proxies
109
 
                                                        (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);</programlisting>
110
 
<para>
111
 
</para>
112
 
<para>
113
 
 
114
 
</para><variablelist role="params">
115
 
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
116
 
<listitem><simpara> A <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link>
117
 
</simpara></listitem></varlistentry>
118
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GList"><type>GList</type></link> of discovered <link linkend="GUPnPDeviceProxy"><type>GUPnPDeviceProxy</type></link> objects. Do not
119
 
free the list nor its elements.
120
 
</simpara></listitem></varlistentry>
121
 
</variablelist></refsect2>
122
 
<refsect2>
123
 
<title><anchor id="gupnp-control-point-list-service-proxies" role="function"/>gupnp_control_point_list_service_proxies ()</title>
124
 
<indexterm><primary>gupnp_control_point_list_service_proxies</primary></indexterm><programlisting>const <link linkend="GList">GList</link>*        gupnp_control_point_list_service_proxies
125
 
                                                        (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);</programlisting>
126
 
<para>
127
 
</para>
128
 
<para>
129
 
 
130
 
</para><variablelist role="params">
131
 
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
132
 
<listitem><simpara> A <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link>
133
 
</simpara></listitem></varlistentry>
134
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GList"><type>GList</type></link> of discovered <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link> objects. Do not
135
 
free the list nor its elements.
136
 
</simpara></listitem></varlistentry>
137
 
</variablelist></refsect2>
138
 
 
139
 
</refsect1>
140
 
 
 
84
<refsect2 id="GUPnPControlPoint-struct" role="struct">
 
85
<title>GUPnPControlPoint</title>
 
86
<indexterm zone="GUPnPControlPoint-struct"><primary>GUPnPControlPoint</primary></indexterm><programlisting>typedef struct _GUPnPControlPoint GUPnPControlPoint;</programlisting>
 
87
<para>
 
88
This struct contains private data only, and should be accessed using the
 
89
functions below.</para>
 
90
<para>
 
91
 
 
92
</para></refsect2>
 
93
<refsect2 id="gupnp-control-point-new" role="function">
 
94
<title>gupnp_control_point_new ()</title>
 
95
<indexterm zone="gupnp-control-point-new"><primary>gupnp_control_point_new</primary></indexterm><programlisting><link linkend="GUPnPControlPoint">GUPnPControlPoint</link>*  gupnp_control_point_new             (<link linkend="GUPnPContext">GUPnPContext</link> *context,
 
96
                                                         const <link linkend="char">char</link> *target);</programlisting>
 
97
<para>
 
98
Create a new <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> with the specified <parameter>context</parameter> and <parameter>target</parameter>.
 
99
</para>
 
100
<para>
 
101
<parameter>target</parameter> should be a service or device name, such as
 
102
<literal>urn:schemas-upnp-org:service:WANIPConnection:1</literal> or
 
103
<literal>urn:schemas-upnp-org:device:MediaRenderer:1</literal>.</para>
 
104
<para>
 
105
 
 
106
</para><variablelist role="params">
 
107
<varlistentry><term><parameter>context</parameter>&nbsp;:</term>
 
108
<listitem><simpara> A <link linkend="GUPnPContext"><type>GUPnPContext</type></link>
 
109
</simpara></listitem></varlistentry>
 
110
<varlistentry><term><parameter>target</parameter>&nbsp;:</term>
 
111
<listitem><simpara> The search target
 
112
</simpara></listitem></varlistentry>
 
113
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A new <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> object.
 
114
</simpara></listitem></varlistentry>
 
115
</variablelist></refsect2>
 
116
<refsect2 id="gupnp-control-point-new-full" role="function">
 
117
<title>gupnp_control_point_new_full ()</title>
 
118
<indexterm zone="gupnp-control-point-new-full"><primary>gupnp_control_point_new_full</primary></indexterm><programlisting><link linkend="GUPnPControlPoint">GUPnPControlPoint</link>*  gupnp_control_point_new_full        (<link linkend="GUPnPContext">GUPnPContext</link> *context,
 
119
                                                         <link linkend="GUPnPResourceFactory">GUPnPResourceFactory</link> *factory,
 
120
                                                         const <link linkend="char">char</link> *target);</programlisting>
 
121
<para>
 
122
Create a new <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> with the specified <parameter>context</parameter>, <parameter>factory</parameter> and
 
123
<parameter>target</parameter>.
 
124
</para>
 
125
<para>
 
126
<parameter>target</parameter> should be a service or device name, such as
 
127
<literal>urn:schemas-upnp-org:service:WANIPConnection:1</literal> or
 
128
<literal>urn:schemas-upnp-org:device:MediaRenderer:1</literal>.</para>
 
129
<para>
 
130
 
 
131
</para><variablelist role="params">
 
132
<varlistentry><term><parameter>context</parameter>&nbsp;:</term>
 
133
<listitem><simpara> A <link linkend="GUPnPContext"><type>GUPnPContext</type></link>
 
134
</simpara></listitem></varlistentry>
 
135
<varlistentry><term><parameter>factory</parameter>&nbsp;:</term>
 
136
<listitem><simpara> A <link linkend="GUPnPResourceFactory"><type>GUPnPResourceFactory</type></link>
 
137
</simpara></listitem></varlistentry>
 
138
<varlistentry><term><parameter>target</parameter>&nbsp;:</term>
 
139
<listitem><simpara> The search target
 
140
</simpara></listitem></varlistentry>
 
141
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A new <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> object.
 
142
</simpara></listitem></varlistentry>
 
143
</variablelist></refsect2>
 
144
<refsect2 id="gupnp-control-point-get-resource-factory" role="function">
 
145
<title>gupnp_control_point_get_resource_factory ()</title>
 
146
<indexterm zone="gupnp-control-point-get-resource-factory"><primary>gupnp_control_point_get_resource_factory</primary></indexterm><programlisting><link linkend="GUPnPResourceFactory">GUPnPResourceFactory</link>* gupnp_control_point_get_resource_factory
 
147
                                                        (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);</programlisting>
 
148
<para>
 
149
Get the <link linkend="GUPnPResourceFactory"><type>GUPnPResourceFactory</type></link> used by the <parameter>control_point</parameter>.</para>
 
150
<para>
 
151
 
 
152
</para><variablelist role="params">
 
153
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
 
154
<listitem><simpara> A <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link>
 
155
</simpara></listitem></varlistentry>
 
156
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GUPnPResourceFactory"><type>GUPnPResourceFactory</type></link>.
 
157
</simpara></listitem></varlistentry>
 
158
</variablelist></refsect2>
 
159
<refsect2 id="gupnp-control-point-get-context" role="function">
 
160
<title>gupnp_control_point_get_context ()</title>
 
161
<indexterm zone="gupnp-control-point-get-context"><primary>gupnp_control_point_get_context</primary></indexterm><programlisting><link linkend="GUPnPContext">GUPnPContext</link>*       gupnp_control_point_get_context     (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);</programlisting>
 
162
<para>
 
163
Get the <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> associated with <parameter>control_point</parameter>.</para>
 
164
<para>
 
165
 
 
166
</para><variablelist role="params">
 
167
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
 
168
<listitem><simpara> A <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link>
 
169
</simpara></listitem></varlistentry>
 
170
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The <link linkend="GUPnPContext"><type>GUPnPContext</type></link>.
 
171
</simpara></listitem></varlistentry>
 
172
</variablelist></refsect2>
 
173
<refsect2 id="gupnp-control-point-list-device-proxies" role="function">
 
174
<title>gupnp_control_point_list_device_proxies ()</title>
 
175
<indexterm zone="gupnp-control-point-list-device-proxies"><primary>gupnp_control_point_list_device_proxies</primary></indexterm><programlisting>const <link linkend="GList">GList</link>*        gupnp_control_point_list_device_proxies
 
176
                                                        (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);</programlisting>
 
177
<para>
 
178
Get the <link linkend="GList"><type>GList</type></link> of discovered <link linkend="GUPnPDeviceProxy"><type>GUPnPDeviceProxy</type></link> objects. Do not free the list
 
179
nor its elements.</para>
 
180
<para>
 
181
 
 
182
</para><variablelist role="params">
 
183
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
 
184
<listitem><simpara> A <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link>
 
185
</simpara></listitem></varlistentry>
 
186
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GList"><type>GList</type></link> of <link linkend="GUPnPDeviceProxy"><type>GUPnPDeviceProxy</type></link> objects.
 
187
</simpara></listitem></varlistentry>
 
188
</variablelist></refsect2>
 
189
<refsect2 id="gupnp-control-point-list-service-proxies" role="function">
 
190
<title>gupnp_control_point_list_service_proxies ()</title>
 
191
<indexterm zone="gupnp-control-point-list-service-proxies"><primary>gupnp_control_point_list_service_proxies</primary></indexterm><programlisting>const <link linkend="GList">GList</link>*        gupnp_control_point_list_service_proxies
 
192
                                                        (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point);</programlisting>
 
193
<para>
 
194
Get the <link linkend="GList"><type>GList</type></link> of discovered <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link> objects. Do not free the list
 
195
nor its elements.</para>
 
196
<para>
 
197
 
 
198
</para><variablelist role="params">
 
199
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
 
200
<listitem><simpara> A <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link>
 
201
</simpara></listitem></varlistentry>
 
202
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GList"><type>GList</type></link> of <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link> objects.
 
203
</simpara></listitem></varlistentry>
 
204
</variablelist></refsect2>
 
205
 
 
206
</refsect1>
 
207
<refsect1 id="GUPnPControlPoint.property-details" role="property_details">
 
208
<title role="property_details.title">Property Details</title>
 
209
<refsect2 id="GUPnPControlPoint--resource-factory"><title>The <literal>&quot;resource-factory&quot;</literal> property</title>
 
210
<indexterm zone="GUPnPControlPoint--resource-factory"><primary>GUPnPControlPoint:resource-factory</primary></indexterm><programlisting>  &quot;resource-factory&quot;         <link linkend="GUPnPResourceFactory">GUPnPResourceFactory</link>*  : Read / Write / Construct Only</programlisting>
 
211
<para>
 
212
The resource factory to use. Set to NULL for default factory.</para>
 
213
<para>
 
214
 
 
215
</para></refsect2>
 
216
 
 
217
</refsect1>
 
218
 
 
219
<refsect1 id="GUPnPControlPoint.signal-details" role="signals">
 
220
<title role="signals.title">Signal Details</title>
 
221
<refsect2 id="GUPnPControlPoint-device-proxy-available"><title>The <literal>&quot;device-proxy-available&quot;</literal> signal</title>
 
222
<indexterm zone="GUPnPControlPoint-device-proxy-available"><primary>GUPnPControlPoint::device-proxy-available</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point,
 
223
                                                        <link linkend="GUPnPDeviceProxy">GUPnPDeviceProxy</link>  *proxy,
 
224
                                                        <link linkend="gpointer">gpointer</link>           user_data)          : Run Last</programlisting>
 
225
<para>
 
226
The ::device-proxy-available signal is emitted whenever a new
 
227
device has become available.</para>
 
228
<para>
 
229
 
 
230
</para><variablelist role="params">
 
231
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
 
232
<listitem><simpara> The <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> that received the signal
 
233
</simpara></listitem></varlistentry>
 
234
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
 
235
<listitem><simpara> The now available <link linkend="GUPnPDeviceProxy"><type>GUPnPDeviceProxy</type></link>
 
236
</simpara></listitem></varlistentry>
 
237
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
238
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
 
239
</variablelist></refsect2><refsect2 id="GUPnPControlPoint-device-proxy-unavailable"><title>The <literal>&quot;device-proxy-unavailable&quot;</literal> signal</title>
 
240
<indexterm zone="GUPnPControlPoint-device-proxy-unavailable"><primary>GUPnPControlPoint::device-proxy-unavailable</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point,
 
241
                                                        <link linkend="GUPnPDeviceProxy">GUPnPDeviceProxy</link>  *proxy,
 
242
                                                        <link linkend="gpointer">gpointer</link>           user_data)          : Run Last</programlisting>
 
243
<para>
 
244
The ::device-proxy-unavailable signal is emitted whenever a
 
245
device is not available any more.</para>
 
246
<para>
 
247
 
 
248
</para><variablelist role="params">
 
249
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
 
250
<listitem><simpara> The <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> that received the signal
 
251
</simpara></listitem></varlistentry>
 
252
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
 
253
<listitem><simpara> The now unavailable <link linkend="GUPnPDeviceProxy"><type>GUPnPDeviceProxy</type></link>
 
254
</simpara></listitem></varlistentry>
 
255
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
256
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
 
257
</variablelist></refsect2><refsect2 id="GUPnPControlPoint-service-proxy-available"><title>The <literal>&quot;service-proxy-available&quot;</literal> signal</title>
 
258
<indexterm zone="GUPnPControlPoint-service-proxy-available"><primary>GUPnPControlPoint::service-proxy-available</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point,
 
259
                                                        <link linkend="GUPnPServiceProxy">GUPnPServiceProxy</link> *proxy,
 
260
                                                        <link linkend="gpointer">gpointer</link>           user_data)          : Run Last</programlisting>
 
261
<para>
 
262
The ::service-proxy-available signal is emitted whenever a new
 
263
service has become available.</para>
 
264
<para>
 
265
 
 
266
</para><variablelist role="params">
 
267
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
 
268
<listitem><simpara> The <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> that received the signal
 
269
</simpara></listitem></varlistentry>
 
270
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
 
271
<listitem><simpara> The now available <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link>
 
272
</simpara></listitem></varlistentry>
 
273
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
274
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
 
275
</variablelist></refsect2><refsect2 id="GUPnPControlPoint-service-proxy-unavailable"><title>The <literal>&quot;service-proxy-unavailable&quot;</literal> signal</title>
 
276
<indexterm zone="GUPnPControlPoint-service-proxy-unavailable"><primary>GUPnPControlPoint::service-proxy-unavailable</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GUPnPControlPoint">GUPnPControlPoint</link> *control_point,
 
277
                                                        <link linkend="GUPnPServiceProxy">GUPnPServiceProxy</link> *proxy,
 
278
                                                        <link linkend="gpointer">gpointer</link>           user_data)          : Run Last</programlisting>
 
279
<para>
 
280
The ::service-proxy-unavailable signal is emitted whenever a
 
281
service is not available any more.</para>
 
282
<para>
 
283
 
 
284
</para><variablelist role="params">
 
285
<varlistentry><term><parameter>control_point</parameter>&nbsp;:</term>
 
286
<listitem><simpara> The <link linkend="GUPnPControlPoint"><type>GUPnPControlPoint</type></link> that received the signal
 
287
</simpara></listitem></varlistentry>
 
288
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
 
289
<listitem><simpara> The now unavailable <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link>
 
290
</simpara></listitem></varlistentry>
 
291
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
292
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
 
293
</variablelist></refsect2>
 
294
</refsect1>
141
295
 
142
296
 
143
297