GUPnPDIDLLiteObject

GUPnPDIDLLiteObject — DIDL-Lite Object

Synopsis

GList*              gupnp_didl_lite_object_get_properties
                                                        (GUPnPDIDLLiteObject *object,
                                                         const char *name);
const char*         gupnp_didl_lite_object_get_id       (GUPnPDIDLLiteObject *object);
const char*         gupnp_didl_lite_object_get_parent_id
                                                        (GUPnPDIDLLiteObject *object);
gboolean            gupnp_didl_lite_object_get_restricted
                                                        (GUPnPDIDLLiteObject *object);
const char*         gupnp_didl_lite_object_get_title    (GUPnPDIDLLiteObject *object);
const char*         gupnp_didl_lite_object_get_creator  (GUPnPDIDLLiteObject *object);
const char*         gupnp_didl_lite_object_get_write_status
                                                        (GUPnPDIDLLiteObject *object);
const char*         gupnp_didl_lite_object_get_upnp_class
                                                        (GUPnPDIDLLiteObject *object);
GList*              gupnp_didl_lite_object_get_resources
                                                        (GUPnPDIDLLiteObject *object);
GUPnPDIDLLiteResource* gupnp_didl_lite_object_get_compat_resource
                                                        (GUPnPDIDLLiteObject *object,
                                                         const char *sink_protocol_info,
                                                         gboolean lenient);

Description

GUPnPDIDLLiteObject respresent a DIDL-Lite object element.

Details

gupnp_didl_lite_object_get_properties ()

GList*              gupnp_didl_lite_object_get_properties
                                                        (GUPnPDIDLLiteObject *object,
                                                         const char *name);

Use this function to retreive property nodes by name.

object : GUPnPDIDLLiteObject
name : name of the properties
Returns : The list of property nodes by the name property_name belonging to object, or NULL. g_list_free the returned list after usage but do not modify the contents.

gupnp_didl_lite_object_get_id ()

const char*         gupnp_didl_lite_object_get_id       (GUPnPDIDLLiteObject *object);

Get the ID of the object.

object : GUPnPDIDLLiteObject
Returns : The ID of the object, or NULL.

gupnp_didl_lite_object_get_parent_id ()

const char*         gupnp_didl_lite_object_get_parent_id
                                                        (GUPnPDIDLLiteObject *object);

Get the ID of the parent of the object.

object : GUPnPDIDLLiteObject
Returns : The ID of parent of the object, or NULL. g_free after usage.

gupnp_didl_lite_object_get_restricted ()

gboolean            gupnp_didl_lite_object_get_restricted
                                                        (GUPnPDIDLLiteObject *object);

Whether the object is restricted or not.

object : GUPnPDIDLLiteObject
Returns : TRUE if object is restricted.

gupnp_didl_lite_object_get_title ()

const char*         gupnp_didl_lite_object_get_title    (GUPnPDIDLLiteObject *object);

Get the title of the object.

object : GUPnPDIDLLiteObject
Returns : The title of the object, or NULL.

gupnp_didl_lite_object_get_creator ()

const char*         gupnp_didl_lite_object_get_creator  (GUPnPDIDLLiteObject *object);

Get the creator of the object.

object : GUPnPDIDLLiteObject
Returns : The creator of the object, or NULL.

gupnp_didl_lite_object_get_write_status ()

const char*         gupnp_didl_lite_object_get_write_status
                                                        (GUPnPDIDLLiteObject *object);

Get the write status of the object.

object : GUPnPDIDLLiteObject
Returns : The write status of the object, or NULL.

gupnp_didl_lite_object_get_upnp_class ()

const char*         gupnp_didl_lite_object_get_upnp_class
                                                        (GUPnPDIDLLiteObject *object);

Get the UPnP class of the object.

object : The GUPnPDIDLLiteObject
Returns : The class of object, or NULL.

gupnp_didl_lite_object_get_resources ()

GList*              gupnp_didl_lite_object_get_resources
                                                        (GUPnPDIDLLiteObject *object);

Use this function to retreive resources from the object.

object : GUPnPDIDLLiteObject
Returns : The list of resources belonging to object, or NULL. g_list_free the returned list after usage and unref each resource in it.

gupnp_didl_lite_object_get_compat_resource ()

GUPnPDIDLLiteResource* gupnp_didl_lite_object_get_compat_resource
                                                        (GUPnPDIDLLiteObject *object,
                                                         const char *sink_protocol_info,
                                                         gboolean lenient);

Use this function to get a resource from the object that is compatible with any of the protocols specified in the sink_protocol_info. The value of sink_protocol_info will typically be acquired from 'Sink' argument of 'GetProtocolInfo' action or 'SinkProtocolInfo' state-variable of a ConnectionManager service.

If lenient is TRUE, the first resource in the list is returned instead of NULL if none of resources and protocols are found to be compatible.

object : GUPnPDIDLLiteObject
sink_protocol_info : The SinkProtocolInfo string from MediaRenderer
lenient : Enable lenient mode
Returns : The resource belonging to object that is comaptible with any of the protocols specified in sink_protocol_info, or NULL. Unref after usage.