gupnp_device_action_callback_set

(PECL gupnp >= 0.1.0)

gupnp_device_action_callback_setDéfinit la fonction de rappel pour un périphérique

Description

bool gupnp_device_action_callback_set ( resource $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ètre action (dans le cas d'un signal GUPNP_SIGNAL_ACTION_INVOKED) ou le message du paramètre error (dans le cas d'un signal GUPNP_SIGNAL_NOTIFY_FAILED), et le troisième, le paramètre arg.

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.

Voir aussi

LoadingChargement en cours