gupnp_control_point_callback_set

(PECL gupnp >= 0.1.0)

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

Description

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

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

LoadingChargement en cours