gupnp_device_action_callback_set
(PECL gupnp >= 0.1.0)
gupnp_device_action_callback_set — Establece una función callback a un dispositivo
Descripción
$root_device
, int $signal
, string $action_name
, mixed $callback
[, mixed $arg
] ) : boolEstablece una función callback para una señal y acción.
Parámetros
-
root_device -
Un identificador de dispositivo raíz, devuelto por gupnp_root_device_new().
-
signal -
El valor de la señal. La señal puede ser uno de los siguientes valores:
-
GUPNP_SIGNAL_ACTION_INVOKED - Emitida siempre que una acción es invoada. El manejador debería procesar la acción y debe llamar a cualquier gupnp_service_action_return() o gupnp_service_action_return_error().
-
GUPNP_SIGNAL_NOTIFY_FAILED - Emitida siempre que una notificación de un cliente falla.
-
-
action_name -
El 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 deaction(en caso de una señal GUPNP_SIGNAL_ACTION_INVOKED) o el mensajeerror(en caso de una señal GUPNP_SIGNAL_NOTIFY_FAILED), y el tercer parámetro esarg. -
arg -
Datos de usuario para el
callback.
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.
Errores/Excepciones
Lanza un E_WARNING tanto con una función callback inválida como con una señal inválida.
add a note
