# 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