gupnp_device_action_callback_set
(PECL gupnp >= 0.1.0)
gupnp_device_action_callback_set — Définit la fonction de rappel pour un périphérique
Description
$root_device
, int $signal
, string $action_name
, mixed $callback
[, mixed $arg
] )Définit une fonction de rappel pour un signal et une action.
Liste de paramètres
-
root_device -
Un identifiant de périphérique racine, retourné par la fonction gupnp_root_device_new().
-
signal -
La valeur du signal. Le signal peut prendre une des valeurs suivantes :
-
GUPNP_SIGNAL_ACTION_INVOKED - Émis lorsqu'une action est invoquée. Le gestionnaire doit exécuter l'action et doit appeler soit la fonction gupnp_service_action_return(), soit la fonction gupnp_service_action_return_error().
-
GUPNP_SIGNAL_NOTIFY_FAILED - Émis lorsqu'une notification au client échoue.
-
-
action_name -
Le nom de l'action.
-
callback -
La fonction de rappel pour un certain signal. Typiquement, la fonction de rappel prend 3 arguments. Le premier est le paramètre
service, le second, l'identifiant du paramètreaction(dans le cas d'un signal GUPNP_SIGNAL_ACTION_INVOKED) ou le message du paramètreerror(dans le cas d'un signal GUPNP_SIGNAL_NOTIFY_FAILED), et le troisième, le paramètrearg. -
arg -
Les données utilisateur pour la fonction de rappel
callback.
Valeurs de retour
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
Erreurs / Exceptions
Émets une alerte de type E_WARNING lorsque la fonction de rappel n'est pas valide, ou lorsque le signal n'est pas valide.
