|
|
GUPnP 0.3 (GUPnP Tools branch)
04-10-2008
|
|
GUPNP_CONTROL_POINT_CALLBACK_SET(3) 1 GUPNP_CONTROL_POINT_CALLBACK_SET(3) gupnp_control_point_callback_set - Set control point callback SYNOPSIS
bool gupnp_control_point_callback_set (resource $cpoint, int $signal, mixed $callback, [mixed $arg]) DESCRIPTION
Set control point callback function for signal. PARAMETERS
o $cpoint - A control point identifier, returned by gupnp_control_point_new(3). o $signal - The value of signal. Signal can be one of the following values: o GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE - Emitted whenever a new device has become available. o GUPNP_SIGNAL_DEVICE_PROXY_UNAVAILABLE - Emitted whenever a device is not available any more. o GUPNP_SIGNAL_SERVICE_PROXY_AVAILABLE - Emitted whenever a new service has become available. o GUPNP_SIGNAL_SERVICE_PROXY_UNAVAILABLE - Emitted whenever a service is not available any more. o $callback - The callback function for the certain signal. Typically, callback function takes on two parameters. The $proxy parameter's iden- tifier being the first, and the $arg second. o $arg - User data for $callback. RETURN VALUES
Returns TRUE on success or FALSE on failure. EXAMPLES
Example #1 Create new UPnP context and start browsing <?php function device_proxy_available_cb($proxy, $arg) { $info = gupnp_device_info_get($proxy); $type = $info['device_type']; $location = $info['location']; printf("Device available: "); printf("type: %s ", $type); printf("location: %s ", $location); } /* Create the UPnP context */ $context = gupnp_context_new(); if (!$context) { die("Error creating the GUPnP context "); } /* We're interested in everything */ $cp = gupnp_control_point_new($context, "ssdp:all"); gupnp_control_point_callback_set($cp, GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE, 'device_proxy_available_cb'); /* Start for browsing */ gupnp_control_point_browse_start($cp); ?> ERRORS
/EXCEPTIONS Issues E_WARNING with not valid callback function. SEE ALSO
gupnp_control_point_new(3), gupnp_control_point_browse_start(3). PHP Documentation Group GUPNP_CONTROL_POINT_CALLBACK_SET(3)