(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
.
成功时返回 TRUE
, 或者在失败时返回 FALSE
.
Issues E_WARNING either with not valid callback function or with not valid signal.