Définit la fonction de rappel pour le point de contrôle

# gupnp_control_point_callback_set

(PECL gupnp >= 0.1.0)

gupnp_control_point_callback_set — Définit la fonction de rappel pour le point de contrôle

### Description

gupnp_control_point_callback_set ( resource `$cpoint` , int `$signal` , mixed `$callback` [, mixed `$arg` ] ) : bool

Définit la fonction de rappel pour le point de contrôle pour un signal donné.

### Liste de paramètres

`cpoint`

  Un identifiant de point de contrôle, retourné par la fonction gupnp_control_point_new().

`signal`

  La valeur du signal. Le signal peut prendre une des valeurs suivantes :

  `GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE`
    Émis lorsqu'un nouveau périphérique devient disponible.
  `GUPNP_SIGNAL_DEVICE_PROXY_UNAVAILABLE`
    Émis lorsqu'un périphérique devient indisponible.
  `GUPNP_SIGNAL_SERVICE_PROXY_AVAILABLE`
    Émis lorsqu'un nouveau service devient disponible.
  `GUPNP_SIGNAL_SERVICE_PROXY_UNAVAILABLE`
    Émis lorsqu'un service devient indisponible.
`callback`

  La fonction de rappel pour un signal spécifique. Typiquement, la fonction de rappel prend 2 arguments. Le paramètre `proxy` sera le premier, et `arg`, le second.

`arg`

  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.

### Exemples

Exemple #1 Création d'un nouveau contexte UPnP et commence la recherche

`<?php
function device_proxy_available_cb($proxy, $arg)
{
$info = gupnp_device_info_get($proxy);
$type = $info['device_type'];
$location = $info['location'];
printf("Device available:\n");
printf("type: %s\n", $type);
printf("location: %s\n", $location);
}
/* Crée un contexte UPnP */
$context = gupnp_context_new();
if (!$context) {
die("Erreur lors de la création du contexte GUPnP\n");
}
/* Nous sommes intéressé par tout ! */
$cp = gupnp_control_point_new($context, "ssdp:all");
gupnp_control_point_callback_set($cp,
GUPNP_SIGNAL_DEVICE_PROXY_AVAILABLE, 'device_proxy_available_cb');
/* Démarre la recherche */
gupnp_control_point_browse_start($cp);
?>`

### Erreurs / Exceptions

Émets une alerte de type E_WARNING si la fonction de rappel n'est pas valide.

### Voir aussi

- gupnp_control_point_new() - Crée un nouveau point de contrôle
- gupnp_control_point_browse_start() - Commence la recherche