TimerDestroy(), TimerDestroy_r()

Удалить таймер

Прототип:

#include <sys/neutrino.h>
int TimerDestroy( timer_t id );
int TimerDestroy_r( timer_t id );

Аргументы:

id
Идентификатор таймера ранее полученный при вызове функции TimerCreate(), который необходимо удалить.

Библиотека:

libc

Описание:

Данные системные вызовы удаляют ранее созданный таймер с идентификатором id. Таймер удаляется из списка активных системных таймеров и возвращается в список доступных таймеров.

Функции TimerDestroy() и TimerDestroy_r() идентичны, но по разному указывают на ошибки.


Note: Рекомендуется использовать функцию timer_delete() вместо прямых системных вызовов.

В случае, если во время выполенния функции TimerDestroy() истекло время срабатывания таймера, таймер будет удален без активации.

Состояния блокировки:

Данные вызовы являются неблокируемыми.

Возвращаемое значение:

TimerDestroy()
Если возникла ошибка функция возвращает -1, код ошибки записывается в errno. Любое другое возвращенное значение считается успешным завершением.
TimerDestroy_r()
EOK возвращается при успешном завершении. Функция НЕ устанавливает errno. При возникновении ошибки функция возвращает один из представленных ниже кодов.

Коды ошибок:

EINVAL
Не существует таймера с идентификатором id.

Классификация:

ЗОСРВ «Нейтрино»

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

timer_t, timer_delete(), TimerCreate()




Предыдущий раздел: Описание API системной библиотеки