Method

GUPnPContextManagermanage_control_point

Declaration [src]

void
gupnp_context_manager_manage_control_point (
  GUPnPContextManager* manager,
  GUPnPControlPoint* control_point
)

Description [src]

By calling this function, you are asking manager to keep a reference to control_point until its associated GUPnPContext is no longer available. You usually want to call this function from your GUPnPContextManager::context-available handler after you create a GUPnPControlPoint object for the newly available context. You usually then give up your own reference to the control point so it will be automatically destroyed if its context is no longer available.

This function is mainly useful when implementing an UPnP client.

void on_context_available (GUPnPContextManager *manager, GUPnPContext *context, gpointer user_data)
{
    GUPnPControlPoint *cp = gupnp_control_point_new (context, "urn:schemas-upnp-org:device:MediaRenderer:1");
    gupnp_context_manager_manage_control_point (manager, cp);
    // Subscribe to control point's signals etc.
    g_object_unref (cp);
}
Available since:0.14.0

Parameters

control_point GUPnPControlPoint
 

The GUPnPControlPoint to be taken care of.

 The data is owned by the caller of the function.