| Top |
GUPnPControlPoint handles device and service discovery. After creating
a control point and activating it using gssdp_resource_browser_set_active(),
the ::device-proxy-available, ::service-proxy-available,
::device-proxy-unavailable and ::service-proxy-unavailable signals will
be emitted whenever the availability of a device or service matching
the specified discovery target changes.
GUPnPControlPoint * gupnp_control_point_new (GUPnPContext *context,const char *target);
Create a new GUPnPControlPoint with the specified context
and target
.
target
should be a service or device name, such as
urn:schemas-upnp-org:service:WANIPConnection:1 or
urn:schemas-upnp-org:device:MediaRenderer:1.
GUPnPControlPoint * gupnp_control_point_new_full (GUPnPContext *context,GUPnPResourceFactory *factory,const char *target);
Create a new GUPnPControlPoint with the specified context
, factory
and
target
.
target
should be a service or device name, such as
urn:schemas-upnp-org:service:WANIPConnection:1 or
urn:schemas-upnp-org:device:MediaRenderer:1.
GUPnPResourceFactory *
gupnp_control_point_get_resource_factory
(GUPnPControlPoint *control_point);
Get the GUPnPResourceFactory used by the control_point
.
GUPnPContext *
gupnp_control_point_get_context (GUPnPControlPoint *control_point);
Get the GUPnPControlPoint associated with control_point
.
const GList *
gupnp_control_point_list_device_proxies
(GUPnPControlPoint *control_point);
Get the GList of discovered GUPnPDeviceProxy objects. Do not free the list nor its elements.
const GList *
gupnp_control_point_list_service_proxies
(GUPnPControlPoint *control_point);
Get the GList of discovered GUPnPServiceProxy objects. Do not free the list nor its elements.
“resource-factory” property“resource-factory” GUPnPResourceFactory *
The resource factory to use. Set to NULL for default factory.
Flags: Read / Write / Construct Only
“device-proxy-available” signalvoid user_function (GUPnPControlPoint *control_point, GUPnPDeviceProxy *proxy, gpointer user_data)
The ::device-proxy-available signal is emitted whenever a new device has become available.
control_point |
The GUPnPControlPoint that received the signal |
|
proxy |
The now available GUPnPDeviceProxy |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“device-proxy-unavailable” signalvoid user_function (GUPnPControlPoint *control_point, GUPnPDeviceProxy *proxy, gpointer user_data)
The ::device-proxy-unavailable signal is emitted whenever a device is not available any more.
control_point |
The GUPnPControlPoint that received the signal |
|
proxy |
The now unavailable GUPnPDeviceProxy |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“service-proxy-available” signalvoid user_function (GUPnPControlPoint *control_point, GUPnPServiceProxy *proxy, gpointer user_data)
The ::service-proxy-available signal is emitted whenever a new service has become available.
control_point |
The GUPnPControlPoint that received the signal |
|
proxy |
The now available GUPnPServiceProxy |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
“service-proxy-unavailable” signalvoid user_function (GUPnPControlPoint *control_point, GUPnPServiceProxy *proxy, gpointer user_data)
The ::service-proxy-unavailable signal is emitted whenever a service is not available any more.
control_point |
The GUPnPControlPoint that received the signal |
|
proxy |
The now unavailable GUPnPServiceProxy |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last