(PECL gupnp >= 0.1.0)
gupnp_device_action_callback_set — Establece una función callback a un dispositivo
$root_device
, int $signal
, string $action_name
, mixed $callback
[, mixed $arg
] ) : boolEstablece una función callback para una señal y acción.
root_deviceUn identificador de dispositivo raíz, devuelto por gupnp_root_device_new().
signalEl valor de la señal. La señal puede ser uno de los siguientes valores:
GUPNP_SIGNAL_ACTION_INVOKEDGUPNP_SIGNAL_NOTIFY_FAILEDaction_nameEl nombre de la acción.
callback
La función callback para determinada señal. Típicamente, la función callback
toma tres parámetros. Siendo el primer parámetro el identificador service,
el segundo parámetro puede ser el identificador de action
(en caso de una señal GUPNP_SIGNAL_ACTION_INVOKED) o
el mensaje error (en caso de una señal GUPNP_SIGNAL_NOTIFY_FAILED),
y el tercer parámetro es arg.
arg
Datos de usuario para el callback.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
Lanza un E_WARNING tanto con una función callback inválida como con una señal inválida.