OS_StopTimer*

Syntax

#include <nitro/os.h>

void OS_StopTimer( OS_TimerId id );
void OS_StopTimer32( OS_Timer32Id id );
void OS_StopTimer48( OS_Timer48Id id );
void OS_StopTimer64( void );

Arguments

id ID of the timer to be stopped (varies according to the number of timers to be stopped)

Return Values

None.

Description

Stops the internal timer.

The OS_StopTimer* function is used to stop timers that were configured using one of the OS_StartTimer* functions.

The id argument is the timer ID and has the same meaning as the argument in the OS_StartTimer* function.

The OS_StopTimer function stops one 16-bit count timer.

The OS_StopTimer32 function stops two consecutive timers. This is convenient when using 32-bit count timers.

The OS_StopTimer48 function stops three consecutive timers. This is convenient when using 48-bit count timers.

The OS_StopTimer64 function stops four consecutive timers. This is convenient when using 64-bit count timers.

When one of these functions is used to stop multiple consecutive timers, it will reset the interrupt handlers for all timers except the one with the highest number. The interrupt handler for the timer with the highest number will not be reset.

See Also

OS_StartTimer*

Revision History

2008/02/02 Added a explanation about stopping multiple consecutive timers.
2004/01/08 Initial version.


CONFIDENTIAL