Destroy a process timer
#include <sys/neutrino.h> int TimerDestroy( timer_t id ); int TimerDestroy_r( timer_t id );
- The ID of the timer that you want to destroy, as returned by TimerCreate().
Use the -l c option to qcc to link against this library. This library is usually included automatically.
These kernel calls remove a previously created timer specified by id. The timer is removed from the active system timer list and returned to the list of available timers.
The TimerDestroy() and TimerDestroy_r() functions are identical except in the way they indicate errors. See the Returns section for details.
If a timeout is pending when TimerDestroy() removes the timer, the timer is removed without being activated.
These calls don't block.
The only difference between these functions is the way they indicate errors:
- If an error occurs, -1 is returned and errno is set. Any other value returned indicates success.
- EOK is returned on success. This function does NOT set errno. If an error occurs, any value in the Errors section may be returned.
- The timer specified by id doesn't exist.