Top | ![]() |
![]() |
![]() |
![]() |
GUPnPContextManager * | gupnp_context_manager_create () |
GUPnPContextManager * | gupnp_context_manager_create_full () |
void | gupnp_context_manager_rescan_control_points () |
void | gupnp_context_manager_manage_control_point () |
void | gupnp_context_manager_manage_root_device () |
guint | gupnp_context_manager_get_port () |
GUPnPWhiteList * | gupnp_context_manager_get_white_list () |
GSocketFamily | gupnp_context_manager_get_socket_family () |
GSSDPUDAVersion | gupnp_context_manager_get_uda_version () |
A Utility class that takes care of creation and destruction of GUPnPContext objects for all available network interfaces as they go up (connect) and down (disconnect), respectively.
GUPnPContextManager *
gupnp_context_manager_create (guint port
);
Factory-method to create a new GUPnPContextManager. The final type of the GUPnPContextManager depends on the compile-time selection or - in case of NetworkManager - on its availability during runtime. If it is not available, the implementation falls back to the basic Unix context manager instead.
Equivalent to calling gupnp_context_manager_create_full (GSSDP_UDA_VERSION_1_0
, G_SOCKET_FAMILY_IPV4
, port);
Since: 0.18.0
GUPnPContextManager * gupnp_context_manager_create_full (GSSDPUDAVersion uda_version
,GSocketFamily family
,guint port
);
Factory-method to create a new GUPnPContextManager. The final type of the GUPnPContextManager depends on the compile-time selection or - in case of NetworkManager - on its availability during runtime. If it is not available, the implementation falls back to the basic Unix context manager instead.
uda_version |
GSSDPUDAVersion the created contexts should implement
(UDA 1.0 or 1.1). For |
|
family |
GSocketFamily to create the context for |
|
port |
Port to create contexts for, or 0 if you don't care what port is used. |
Since: 1.2.0
void
gupnp_context_manager_rescan_control_points
(GUPnPContextManager *manager
);
This function starts a rescan on every control point managed by manager
.
Only the active control points send discovery messages.
This function should be called when servers are suspected to have
disappeared.
Since: 0.20.3
void gupnp_context_manager_manage_control_point (GUPnPContextManager *manager
,GUPnPControlPoint *control_point
);
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
“context-available” handler after you create a
GUPnPControlPoint object for the newly available context.
Since: 0.14.0
void gupnp_context_manager_manage_root_device (GUPnPContextManager *manager
,GUPnPRootDevice *root_device
);
By calling this function, you are asking manager
to keep a reference to
root_device
when its associated GUPnPContext is no longer available. You
usually want to call this function from
“context-available” handler after you create a
GUPnPRootDevice object for the newly available context.
Since: 0.14.0
guint
gupnp_context_manager_get_port (GUPnPContextManager *manager
);
Get the network port associated with this context manager.
Since: 0.20.0
GUPnPWhiteList *
gupnp_context_manager_get_white_list (GUPnPContextManager *manager
);
gupnp_context_manager_get_white_list
has been deprecated since version 1.4.0 and should not be used in newly-written code.
Use gupnp_context_manager_get_context_filter()
instead.
Get the GUPnPContextFilter associated with manager
.
GSocketFamily
gupnp_context_manager_get_socket_family
(GUPnPContextManager *manager
);
Get the GSocketFamily the contexts are created for. Can be
G_SOCKET_FAMILY_IPV6
, G_SOCKET_FAMILY_IPV4
or G_SOCKET_FAMILY_INVALID
for
both
Since: 1.2.0
GSSDPUDAVersion
gupnp_context_manager_get_uda_version (GUPnPContextManager *manager
);
Get the UDA protocol version the contexts are implementing
Since: 1.2.0