![]() |
![]() |
![]() |
GUPnP Reference Manual | ![]() |
---|---|---|---|---|
GUPnPControlPoint; GUPnPControlPoint* gupnp_control_point_new (GUPnPContext *context, const char *target); GUPnPControlPoint* gupnp_control_point_new_full (GUPnPContext *context, GUPnPResourceFactory *factory, const char *target); GUPnPResourceFactory* gupnp_control_point_get_resource_factory (GUPnPControlPoint *control_point); GUPnPContext* gupnp_control_point_get_context (GUPnPControlPoint *control_point); const GList* gupnp_control_point_list_device_proxies (GUPnPControlPoint *control_point); const GList* gupnp_control_point_list_service_proxies (GUPnPControlPoint *control_point);
"device-proxy-available" : Run Last "device-proxy-unavailable" : Run Last "service-proxy-available" : Run Last "service-proxy-unavailable" : Run Last
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.
typedef struct _GUPnPControlPoint GUPnPControlPoint;
This struct contains private data only, and should be accessed using the functions below.
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
.
context : |
A GUPnPContext |
target : |
The search target |
Returns : | A new GUPnPControlPoint object. |
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
.
context : |
A GUPnPContext |
factory : |
A GUPnPResourceFactory |
target : |
The search target |
Returns : | A new GUPnPControlPoint object. |
GUPnPResourceFactory* gupnp_control_point_get_resource_factory (GUPnPControlPoint *control_point);
Get the GUPnPResourceFactory used by the control_point
.
control_point : |
A GUPnPControlPoint |
Returns : | A GUPnPResourceFactory. |
GUPnPContext* gupnp_control_point_get_context (GUPnPControlPoint *control_point);
Get the GUPnPControlPoint associated with control_point
.
control_point : |
A GUPnPControlPoint |
Returns : | The GUPnPContext. |
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.
control_point : |
A GUPnPControlPoint |
Returns : | a GList of GUPnPDeviceProxy objects. |
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.
control_point : |
A GUPnPControlPoint |
Returns : | a GList of GUPnPServiceProxy objects. |
"resource-factory"
property"resource-factory" GUPnPResourceFactory* : Read / Write / Construct Only
The resource factory to use. Set to NULL for default factory.
"device-proxy-available"
signalvoid user_function (GUPnPControlPoint *control_point, GUPnPDeviceProxy *proxy, gpointer user_data) : Run Last
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. |
"device-proxy-unavailable"
signalvoid user_function (GUPnPControlPoint *control_point, GUPnPDeviceProxy *proxy, gpointer user_data) : Run Last
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. |
"service-proxy-available"
signalvoid user_function (GUPnPControlPoint *control_point, GUPnPServiceProxy *proxy, gpointer user_data) : Run Last
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. |
"service-proxy-unavailable"
signalvoid user_function (GUPnPControlPoint *control_point, GUPnPServiceProxy *proxy, gpointer user_data) : Run Last
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. |