gupnp_device_action_callback_set

(PECL gupnp >= 0.1.0)

gupnp_device_action_callback_setУстанавливает callback-функцию устройства

Описание

gupnp_device_action_callback_set ( resource $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_service_action_return(), либо gupnp_service_action_return_error().
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-функцией, либо с недопустимым сигналом.

Смотрите также

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top