GUPnPDeviceInfo

GUPnPDeviceInfo — Interface for querying device information.

Synopsis




                    GUPnPDeviceInfoPrivate;
                    GUPnPDeviceInfo;
GUPnPContext*       gupnp_device_info_get_context       (GUPnPDeviceInfo *info);
const char*         gupnp_device_info_get_location      (GUPnPDeviceInfo *info);
const char*         gupnp_device_info_get_udn           (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_device_type   (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_friendly_name (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_manufacturer  (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_manufacturer_url
                                                        (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_model_description
                                                        (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_model_name    (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_model_number  (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_model_url     (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_serial_number (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_upc           (GUPnPDeviceInfo *info);
char*               gupnp_device_info_get_icon_url      (GUPnPDeviceInfo *info,
                                                         const char *requested_mime_type,
                                                         int requested_depth,
                                                         int requested_width,
                                                         int requested_height,
                                                         gboolean prefer_bigger,
                                                         char **mime_type,
                                                         int *depth,
                                                         int *width,
                                                         int *height);

Object Hierarchy


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

Properties


  "context"                  GUPnPContext          : Read / Write / Construct Only
  "location"                 gchararray            : Read / Write / Construct Only
  "udn"                      gchararray            : Read / Write / Construct Only

Description

The GUPnPDeviceInfo interface provides methods for querying device information.

Details

GUPnPDeviceInfoPrivate

typedef struct _GUPnPDeviceInfoPrivate GUPnPDeviceInfoPrivate;


GUPnPDeviceInfo

typedef struct _GUPnPDeviceInfo GUPnPDeviceInfo;


gupnp_device_info_get_context ()

GUPnPContext*       gupnp_device_info_get_context       (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The associated GUPnPContext.

gupnp_device_info_get_location ()

const char*         gupnp_device_info_get_location      (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The location of the device description file.

gupnp_device_info_get_udn ()

const char*         gupnp_device_info_get_udn           (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The UDN.

gupnp_device_info_get_device_type ()

char*               gupnp_device_info_get_device_type   (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The UPnP device type, or NULL. g_free() after use.

gupnp_device_info_get_friendly_name ()

char*               gupnp_device_info_get_friendly_name (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The friendly name, or NULL. g_free() after use.

gupnp_device_info_get_manufacturer ()

char*               gupnp_device_info_get_manufacturer  (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The manufacturer, or NULL. g_free() after use.

gupnp_device_info_get_manufacturer_url ()

char*               gupnp_device_info_get_manufacturer_url
                                                        (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : A URL pointing to the manufacturers website, or NULL. g_free() after use.

gupnp_device_info_get_model_description ()

char*               gupnp_device_info_get_model_description
                                                        (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The description of the device model, or NULL. g_free() after use.

gupnp_device_info_get_model_name ()

char*               gupnp_device_info_get_model_name    (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The name of the device model, or NULL. g_free() after use.

gupnp_device_info_get_model_number ()

char*               gupnp_device_info_get_model_number  (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The model number, or NULL. g_free() after use.

gupnp_device_info_get_model_url ()

char*               gupnp_device_info_get_model_url     (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : A URL pointing to the device models website, or NULL. g_free() after use.

gupnp_device_info_get_serial_number ()

char*               gupnp_device_info_get_serial_number (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The serial number, or NULL. g_free() after use.

gupnp_device_info_get_upc ()

char*               gupnp_device_info_get_upc           (GUPnPDeviceInfo *info);

info : A GUPnPDeviceInfo
Returns : The UPC, or NULL. g_free() after use.

gupnp_device_info_get_icon_url ()

char*               gupnp_device_info_get_icon_url      (GUPnPDeviceInfo *info,
                                                         const char *requested_mime_type,
                                                         int requested_depth,
                                                         int requested_width,
                                                         int requested_height,
                                                         gboolean prefer_bigger,
                                                         char **mime_type,
                                                         int *depth,
                                                         int *width,
                                                         int *height);

info : A GUPnPDeviceInfo
requested_mime_type : The requested file format, or NULL for any
requested_depth : The requested color depth, or -1 for any
requested_width : The requested width, or -1 for any
requested_height : The requested height, or -1 for any
prefer_bigger : TRUE if a bigger, rather than a smaller icon should be returned if no exact match could be found
mime_type : The location where to store the the format of the returned icon, or NULL. The returned string should be freed after use
depth : The location where to store the depth of the returned icon, or NULL
width : The location where to store the width of the returned icon, or NULL
height : The location where to store the height of the returned icon, or NULL
Returns : A URL pointing to the icon most closely matching the given criteria, or NULL. If requested_mime_type is set, only icons with this mime type will be returned. If requested_depth is set, only icons with this or lower depth will be returned. If requested_width and/or requested_height are set, only icons that are this size or smaller are returned, unless prefer_bigger is set, in which case the next biggest icon will be returned. The returned strings should be freed.

Property Details

The "context" property

  "context"                  GUPnPContext          : Read / Write / Construct Only

The GUPnPContext to use.


The "location" property

  "location"                 gchararray            : Read / Write / Construct Only

The location of the device description file.

Default value: NULL


The "udn" property

  "udn"                      gchararray            : Read / Write / Construct Only

The UDN of this device.

Default value: NULL