GUPnPDeviceProxy

GUPnPDeviceProxy — Proxy class for remote devices.

Synopsis




                    GUPnPDeviceProxyPrivate;
                    GUPnPDeviceProxy;
GUPnPDeviceProxy*   gupnp_device_proxy_new              (GUPnPContext *context,
                                                         xmlDoc *doc,
                                                         const char *udn,
                                                         const char *location);
GList*              gupnp_device_proxy_list_devices     (GUPnPDeviceProxy *proxy);
GList*              gupnp_device_proxy_list_device_types
                                                        (GUPnPDeviceProxy *proxy);
GUPnPDeviceProxy*   gupnp_device_proxy_get_device       (GUPnPDeviceProxy *proxy,
                                                         const char *type);
GList*              gupnp_device_proxy_list_services    (GUPnPDeviceProxy *proxy);
GList*              gupnp_device_proxy_list_service_types
                                                        (GUPnPDeviceProxy *proxy);
GUPnPServiceProxy*  gupnp_device_proxy_get_service      (GUPnPDeviceProxy *proxy,
                                                         const char *type);

Object Hierarchy


  GObject
   +----GUPnPDeviceInfo
         +----GUPnPDeviceProxy

Description

GUPnPServiceProxy allows for retrieving proxies for a device's subdevices and services. Device proxies also implement the GUPnPDeviceInfo interface.

Details

GUPnPDeviceProxyPrivate

typedef struct _GUPnPDeviceProxyPrivate GUPnPDeviceProxyPrivate;


GUPnPDeviceProxy

typedef struct _GUPnPDeviceProxy GUPnPDeviceProxy;


gupnp_device_proxy_new ()

GUPnPDeviceProxy*   gupnp_device_proxy_new              (GUPnPContext *context,
                                                         xmlDoc *doc,
                                                         const char *udn,
                                                         const char *location);

context : A GUPnPContext
doc : A device description document
udn : The UDN of the device to create a proxy for.
location : The location of the device description file
Returns : A GUPnPDeviceProxy for the device with UDN udn, as read from the device description doc.

gupnp_device_proxy_list_devices ()

GList*              gupnp_device_proxy_list_devices     (GUPnPDeviceProxy *proxy);

proxy : A GUPnPDeviceProxy
Returns : A GList of GUPnPDeviceProxy objects representing the devices directly contained in proxy. The returned list should be g_list_free()'d and the elements should be g_object_unref()'d.

gupnp_device_proxy_list_device_types ()

GList*              gupnp_device_proxy_list_device_types
                                                        (GUPnPDeviceProxy *proxy);

proxy : A GUPnPDeviceProxy
Returns : A GList of strings representing the types of the devices directly contained in proxy. The returned list should be g_list_free()'d and the elements should be g_free()'d.

gupnp_device_proxy_get_device ()

GUPnPDeviceProxy*   gupnp_device_proxy_get_device       (GUPnPDeviceProxy *proxy,
                                                         const char *type);

proxy : A GUPnPDeviceProxy
type : The type of the device to be retrieved.
Returns : The device with type type directly contained in proxy as a GUPnPDeviceProxy object, or NULL if no such device was found.

gupnp_device_proxy_list_services ()

GList*              gupnp_device_proxy_list_services    (GUPnPDeviceProxy *proxy);

proxy : A GUPnPDeviceProxy
Returns : A GList of GUPnPServiceProxy objects representing the services directly contained in proxy. The returned list should be g_list_free()'d and the elements should be g_object_unref()'d.

gupnp_device_proxy_list_service_types ()

GList*              gupnp_device_proxy_list_service_types
                                                        (GUPnPDeviceProxy *proxy);

proxy : A GUPnPDeviceProxy
Returns : A GList of strings representing the types of the services directly contained in proxy. The returned list should be g_list_free()'d and the elements should be g_free()'d.

gupnp_device_proxy_get_service ()

GUPnPServiceProxy*  gupnp_device_proxy_get_service      (GUPnPDeviceProxy *proxy,
                                                         const char *type);

proxy : A GUPnPDeviceProxy
type : The type of the service to be retrieved.
Returns : The service with type type directly contained in proxy as a GUPnPServiceProxy object, or NULL if no such service was found.