(PECL gupnp >= 0.1.0)
gupnp_device_action_callback_set — Устанавливает callback-функцию устройства
$root_device
, int $signal
, string $action_name
, mixed $callback
[, mixed $arg
] ) : boolУстанавливает callback-функцию устройства для сигнала и действия.
root_device
Идентификатор корневого устройства, возвращаемый gupnp_root_device_new().
signal
Значение сигнала. Сигнал может быть одним из следующих значений:
GUPNP_SIGNAL_ACTION_INVOKED
GUPNP_SIGNAL_NOTIFY_FAILED
action_name
Имя действия.
callback
Callback-функция для определенного сигнала. Обычно callback-функция
принимает три параметра. Идентификатор параметра service
является первым, идентификатор параметра action
(в случае сигнала GUPNP_SIGNAL_ACTION_INVOKED) или сообщение параметра
error
(в случае сигнала GUPNP_SIGNAL_NOTIFY_FAILED) -
вторым, а arg
- третьим.
arg
Пользовательские данные для callback
.
Возвращает TRUE
в случае успешного завершения или FALSE
в случае возникновения ошибки.
Выдает E_WARNING в случае с недопустимой callback-функцией, либо с недопустимым сигналом.