1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>OS_StopTimer</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">OS_StopTimer* <IMG src="../../image/NTR.gif" align="middle"><IMG src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14<DD><CODE>#include &lt;nitro/os.h&gt;</CODE><BR> <BR> <CODE>void OS_StopTimer( OS_TimerId id );<BR> void OS_StopTimer32( OS_Timer32Id id );<BR> void OS_StopTimer48( OS_Timer48Id id );<BR> void OS_StopTimer64( void );</CODE>
15</DL>
16<H2>Arguments</H2>
17<TABLE border="1" width="100%">
18  <TBODY>
19    <TR>
20<TD width="13%"><CODE>id</CODE></TD>
21<TD width="87%">ID of the timer to be stopped (varies according to the number of timers to be stopped)</TD>
22    </TR>
23  </TBODY>
24</TABLE>
25<H2>Return Values</H2>
26<P>None.</P>
27<H2>Description</H2>
28<P>Stops the internal timer.</P>
29<P>The <CODE>OS_StopTimer*</CODE> function is used to stop timers that were configured using one of the <A href="OS_StartTimer.html"><CODE>OS_StartTimer*</CODE></A> functions.</P>
30<P>The <CODE>id</CODE> argument is the timer ID and has the same meaning as the argument in the <A href="OS_StartTimer.html"><CODE>OS_StartTimer*</CODE></A> function.</P>
31<P>The <code>OS_StopTimer</code> function stops one 16-bit count timer.</P>
32<P>The <code>OS_StopTimer32</code> function stops two consecutive timers. This is convenient when using 32-bit count timers.</P>
33<P>The <code>OS_StopTimer48</code> function stops three consecutive timers. This is convenient when using 48-bit count timers.</P>
34<P>The <code>OS_StopTimer64</code> function stops four consecutive timers. This is convenient when using 64-bit count timers.</P>
35<P>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.</P>
36<H2>See Also</H2>
37<P><A href="OS_StartTimer.html"><CODE>OS_StartTimer*</CODE></A></P>
38<H2>Revision History</H2>
39<P>2008/02/02 Added a explanation about stopping multiple consecutive timers.<BR> 2004/01/08 Initial version.</P>
40<hr><p>CONFIDENTIAL</p></body>
41</HTML>