![]() |
![]() |
![]() |
GUPnP Reference Manual | ![]() |
---|---|---|---|---|
GUPnPDeviceInfo; GUPnPResourceFactory* gupnp_device_info_get_resource_factory (GUPnPDeviceInfo *device_info); GUPnPContext* gupnp_device_info_get_context (GUPnPDeviceInfo *info); constchar * gupnp_device_info_get_location (GUPnPDeviceInfo *info); constSoupURI * gupnp_device_info_get_url_base (GUPnPDeviceInfo *info); constchar * gupnp_device_info_get_udn (GUPnPDeviceInfo *info); constchar * 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, constchar *requested_mime_type,int requested_depth,int requested_width,int requested_height,gboolean prefer_bigger,char **mime_type,int *depth,int *width,int *height);GList * gupnp_device_info_list_devices (GUPnPDeviceInfo *info);GList * gupnp_device_info_list_device_types (GUPnPDeviceInfo *info); GUPnPDeviceInfo* gupnp_device_info_get_device (GUPnPDeviceInfo *info, constchar *type);GList * gupnp_device_info_list_services (GUPnPDeviceInfo *info);GList * gupnp_device_info_list_service_types (GUPnPDeviceInfo *info); GUPnPServiceInfo* gupnp_device_info_get_service (GUPnPDeviceInfo *info, constchar *type);
"context" GUPnPContext* : Read / Write / Construct Only "device-type"gchar * : Read / Write / Construct Only "document"XmlDocWrapper * : Write / Construct Only "element"gpointer : Write / Construct Only "location"gchar * : Read / Write / Construct Only "resource-factory" GUPnPResourceFactory* : Read / Write / Construct Only "udn"gchar * : Read / Write / Construct Only "url-base"gpointer : Read / Write / Construct Only
The GUPnPDeviceInfo base abstract class provides methods for querying device information.
typedef struct _GUPnPDeviceInfo GUPnPDeviceInfo;
This struct contains private data only, and should be accessed using the functions below.
GUPnPResourceFactory* gupnp_device_info_get_resource_factory (GUPnPDeviceInfo *device_info);
|
A GUPnPDeviceInfo |
Returns : |
The GUPnPResourceFactory used by the device_info .
|
GUPnPContext* gupnp_device_info_get_context (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The associated GUPnPContext. |
constchar * gupnp_device_info_get_location (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The location of the device description file. |
constSoupURI * gupnp_device_info_get_url_base (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The URL base. |
constchar * gupnp_device_info_get_udn (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The UDN. |
constchar * gupnp_device_info_get_device_type (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The UPnP device type, or NULL. |
char * gupnp_device_info_get_friendly_name (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The friendly name, or NULL. g_free() |
char * gupnp_device_info_get_manufacturer (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The manufacturer, or NULL. g_free() |
char * gupnp_device_info_get_manufacturer_url (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
A URL pointing to the manufacturers website, or NULL.
g_free() |
char * gupnp_device_info_get_model_description (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The description of the device model, or NULL. g_free() |
char * gupnp_device_info_get_model_name (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The name of the device model, or NULL. g_free() |
char * gupnp_device_info_get_model_number (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The model number, or NULL. g_free() |
char * gupnp_device_info_get_model_url (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
A URL pointing to the device models website, or NULL.
g_free() |
char * gupnp_device_info_get_serial_number (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The serial number, or NULL. g_free() |
char * gupnp_device_info_get_upc (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
The UPC, or NULL. g_free() |
char * gupnp_device_info_get_icon_url (GUPnPDeviceInfo *info, constchar *requested_mime_type,int requested_depth,int requested_width,int requested_height,gboolean prefer_bigger,char **mime_type,int *depth,int *width,int *height);
|
A GUPnPDeviceInfo |
|
The requested file format, or NULL for any |
|
The requested color depth, or -1 for any |
|
The requested width, or -1 for any |
|
The requested height, or -1 for any |
|
TRUE if a bigger, rather than a smaller icon should be returned if no exact match could be found |
|
The location where to store the the format of the returned icon, or NULL. The returned string should be freed after use |
|
The location where to store the depth of the returned icon, or NULL |
|
The location where to store the width of the returned icon, or NULL |
|
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.
|
GList * gupnp_device_info_list_devices (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
A info . The returned list
should be g_list_free() g_object_unref() |
GList * gupnp_device_info_list_device_types (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
A info . The returned list should be g_list_free() g_free() |
GUPnPDeviceInfo* gupnp_device_info_get_device (GUPnPDeviceInfo *info, constchar *type);
|
A GUPnPDeviceInfo |
|
The type of the device to be retrieved. |
Returns : |
The service with type type directly contained in info as
a new object implementing GUPnPDeviceInfo, or NULL if no such device
was found. The returned object should be unreffed when done.
Note that devices are not cached internally, so that every time you
call this function a new object is created. The application
must cache any used devices if it wishes to keep them around and re-use
them.
|
GList * gupnp_device_info_list_services (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
A info . The returned list
should be g_list_free() g_object_unref() |
GList * gupnp_device_info_list_service_types (GUPnPDeviceInfo *info);
|
A GUPnPDeviceInfo |
Returns : |
A info . The returned list should be g_list_free() g_free() |
GUPnPServiceInfo* gupnp_device_info_get_service (GUPnPDeviceInfo *info, constchar *type);
|
A GUPnPDeviceInfo |
|
The type of the service to be retrieved. |
Returns : |
The service with type type directly contained in info as
a new object implementing GUPnPServiceInfo, or NULL if no such device
was found. The returned object should be unreffed when done.
Note that services are not cached internally, so that every time you
call this function a new object is created. The application
must cache any used services if it wishes to keep them around and re-use
them.
|
"context"
property"context" GUPnPContext* : Read / Write / Construct Only
The GUPnPContext to use.
"device-type"
property"device-type"gchar * : Read / Write / Construct Only
The device type.
Default value: NULL
"document"
property"document"XmlDocWrapper * : Write / Construct Only
Private property.
Stability Level Private
"element"
property"element"gpointer : Write / Construct Only
Private property.
Stability Level Private
"location"
property"location"gchar * : Read / Write / Construct Only
The location of the device description file.
Default value: NULL
"resource-factory"
property"resource-factory" GUPnPResourceFactory* : Read / Write / Construct Only
The resource factory to use. Set to NULL for default factory.
"udn"
property"udn"gchar * : Read / Write / Construct Only
The UDN of this device.
Default value: NULL