GUPnP Reference Manual | ||||
---|---|---|---|---|
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);
"available" gboolean : Read / Write "description-dir" gchar* : Read / Write / Construct Only "description-doc" GUPnPXMLDoc* : Write / Construct Only "description-path" gchar* : Read / Write / Construct Only
typedef struct _GUPnPRootDevice 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
.
context : |
The GUPnPContext |
description_path : |
Path to device description document. This could either
be an absolute path or path relative to description_dir .
|
description_dir : |
Path to directory where description documents are provided. |
Returns : | A new GUPnPRootDevice object.
|
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
.
context : |
A GUPnPContext |
factory : |
A GUPnPResourceFactory |
description_doc : |
Device description document, or NULL
|
description_path : |
Path to device description document. This could either
be an absolute path or path relative to description_dir .
|
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).
root_device : |
A GUPnPRootDevice |
available : |
TRUE if root_device should be available
|
gboolean gupnp_root_device_get_available (GUPnPRootDevice *root_device);
Get whether or not root_device
is available (announcing its presence).
root_device : |
A GUPnPRootDevice |
Returns : | TRUE if root_device is available, FALSE otherwise.
|
const char* gupnp_root_device_get_relative_location (GUPnPRootDevice *root_device);
Get the relative location of root_device
.
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
.
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
.
root_device : |
A GUPnPRootDevice |
Returns : | The path to device description document of root_device .
|
"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.