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() идентичны, но по разному указывают на ошибки.

---

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

---

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

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

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

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

TimerDestroy()

Если возникла ошибка функция возвращает -1, код ошибки записывается в errno. Любое другое возвращенное значение считается успешным завершением.

TimerDestroy_r()

EOK возвращается при успешном завершении. Функция НЕ устанавливает errno. При возникновении ошибки функция возвращает один из представленных ниже кодов.

Коды ошибок:

EINVAL

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

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

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

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Да

В потоке

Да

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

timer_t, timer_delete(), TimerCreate()

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