TimerDestroy(), TimerDestroy_r()
QNX SDP8.0C Library ReferenceAPIDeveloper
Destroy a process timer
Synopsis:
#include <sys/neutrino.h>
int TimerDestroy( timer_t id );
int TimerDestroy_r( timer_t id );
Arguments:
- id
- The ID of the timer that you want to destroy, as returned by TimerCreate().
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
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.
Note:
Instead of using these kernel calls directly, consider calling
timer_delete().
If a timeout is pending when TimerDestroy() removes the timer, the timer is removed without being activated.
Blocking states
These calls don't block.
Returns:
The only difference between these functions is the way they indicate errors:
- TimerDestroy()
- If an error occurs, -1 is returned and errno is set. Any other value returned indicates success.
- TimerDestroy_r()
- EOK is returned on success. This function does NOT set errno. If an error occurs, any value in the Errors section may be returned.
Errors:
- EINVAL
- The timer specified by id doesn't exist.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: