|  |  |  | GUPnP Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
struct GUPnPRootDevice; GUPnPRootDevice * gupnp_root_device_new (GUPnPContext *context,const char *description_path,const char *description_dir); GUPnPRootDevice * gupnp_root_device_new_full (GUPnPContext *context,GUPnPResourceFactory *factory,GUPnPXMLDoc *description_doc,const char *description_path,const char *description_dir); void gupnp_root_device_set_available (GUPnPRootDevice *root_device,gboolean available); gboolean gupnp_root_device_get_available (GUPnPRootDevice *root_device); const char * gupnp_root_device_get_relative_location (GUPnPRootDevice *root_device); const char * gupnp_root_device_get_description_dir (GUPnPRootDevice *root_device); const char * gupnp_root_device_get_description_path (GUPnPRootDevice *root_device); GSSDPResourceGroup * gupnp_root_device_get_ssdp_resource_group (GUPnPRootDevice *root_device);
"available" gboolean : Read / Write "description-dir" gchar* : Read / Write / Construct Only "description-doc" GUPnPXMLDoc* : Write / Construct Only "description-path" gchar* : Read / Write / Construct Only
struct GUPnPRootDevice;
This struct contains private data only, and should be accessed using the functions below.
GUPnPRootDevice * gupnp_root_device_new (GUPnPContext *context,const char *description_path,const char *description_dir);
Create a new GUPnPRootDevice object, automatically loading and parsing
device description document from description_path.
| 
 | The GUPnPContext | 
| 
 | Path to device description document. This could either
be an absolute path or path relative to description_dir. | 
| 
 | Path to directory where description documents are provided. | 
| Returns : | A new GUPnPRootDeviceobject. | 
GUPnPRootDevice * gupnp_root_device_new_full (GUPnPContext *context,GUPnPResourceFactory *factory,GUPnPXMLDoc *description_doc,const char *description_path,const char *description_dir);
Create a new GUPnPRootDevice, automatically loading and parsing
device description document from description_path if description_doc is
NULL.
| 
 | A GUPnPContext | 
| 
 | A GUPnPResourceFactory | 
| 
 | Device description document, or NULL | 
| 
 | Path to device description document. This could either
be an absolute path or path relative to description_dir. | 
| 
 | Path to directory where description documents are provided. | 
| Returns : | A new GUPnPRootDevice object. | 
void gupnp_root_device_set_available (GUPnPRootDevice *root_device,gboolean available);
Controls whether or not root_device is available (announcing
its presence).
| 
 | A GUPnPRootDevice | 
| 
 | TRUEifroot_deviceshould be available | 
gboolean            gupnp_root_device_get_available     (GUPnPRootDevice *root_device);
Get whether or not root_device is available (announcing its presence).
| 
 | A GUPnPRootDevice | 
| Returns : | TRUEifroot_deviceis available,FALSEotherwise. | 
const char *        gupnp_root_device_get_relative_location
                                                        (GUPnPRootDevice *root_device);
Get the relative location of root_device.
| 
 | A GUPnPRootDevice | 
| Returns : | The relative location of root_device. | 
const char *        gupnp_root_device_get_description_dir
                                                        (GUPnPRootDevice *root_device);
Get the path to the directory containing description documents related to
root_device.
| 
 | A GUPnPRootDevice | 
| Returns : | The path to description document directory of root_device. | 
const char *        gupnp_root_device_get_description_path
                                                        (GUPnPRootDevice *root_device);
Get the path to the device description document of root_device.
| 
 | A GUPnPRootDevice | 
| Returns : | The path to device description document of root_device. | 
GSSDPResourceGroup * gupnp_root_device_get_ssdp_resource_group
                                                        (GUPnPRootDevice *root_device);
Get the GSSDPResourceGroup used by root_device.
| 
 | A GUPnPRootDevice | 
| Returns : | The GSSDPResourceGroup of root_device. [transfer none] | 
"available" property"available" gboolean : Read / Write
TRUE if this device is available.
Default value: FALSE
"description-dir" property"description-dir" gchar* : Read / Write / Construct Only
The path to directory where description documents are provided.
Default value: NULL
"description-doc" property"description-doc" GUPnPXMLDoc* : Write / Construct Only
Device description document. Constructor property.
"description-path" property"description-path" gchar* : Read / Write / Construct Only
The path to device description document. This could either be an absolute path or path relative to GUPnPRootDevice:description-dir.
Default value: NULL