(PECL gupnp >= 0.1.0)
gupnp_device_action_callback_set — Set device callback function
$root_device
, int $signal
, string $action_name
, mixed $callback
[, mixed $arg
] )Set device callback function for signal and action.
root_device
A root device identifier, returned by gupnp_root_device_new().
signal
The value of signal. Signal can be one of the following values:
GUPNP_SIGNAL_ACTION_INVOKED
GUPNP_SIGNAL_NOTIFY_FAILED
action_name
The name of action.
callback
The callback function for the certain signal. Typically, callback function
takes on three parameters. The service
parameter's
identifier being the first, action
parameter's
identifier (in case GUPNP_SIGNAL_ACTION_INVOKED signal) or
error
parameter's message (in case GUPNP_SIGNAL_NOTIFY_FAILED
signal) being the second, and the arg
is third.
arg
User data for callback
.
Returns TRUE
on success or FALSE
on failure.
Issues E_WARNING either with not valid callback function or with not valid signal.