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_CheckStack</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">OS_CheckStack <IMG src="../../image/NTR.gif" align="middle"><IMG src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15  <PRE><CODE>#include &lt;nitro/os.h&gt;</CODE></PRE>
16  <PRE><CODE>void OS_CheckStack( const OSThread* thread );
17 </CODE></PRE>
18</DL>
19<H2>Arguments</H2>
20<TABLE border="1" width="100%">
21  <TBODY>
22    <TR>
23      <TD width="13%"><EM><STRONG>thread</STRONG></EM></TD>
24      <TD width="87%">The thread to be checked.</TD>
25    </TR>
26  </TBODY>
27</TABLE>
28<H2>Return Values</H2>
29<P>None.</P>
30<H2>Description</H2>
31<P>Checks for stack overflow with the specified thread</P>
32<P>This function checks the magic numbers written in the stack's highest and lowest locations (and, if set, the warning level location set by the user) to see if they have been rewritten (if the section has been used one or more times). If they have been used, <a href="../debug/OS_Panic.html"><code>OS_Panic()</code></a> will be called and the program will stop.</P>
33<P>This function is for debugging, so it will not effect the FINALROM.</P>
34<H2>See Also</H2>
35<P><code><a href="OS_SetThreadStackWarningOffset.html">OS_SetThreadStackWarningOffset</a></code>, <code><a href="OS_GetStackStatus.html">OS_GetStackStatus</a></code></P>
36<H2>Revision History</H2>
37<P>2005/09/06 Added const to OSThread* type argument.<BR> 2004/04/29 Deleted precaution about threads which cannot be checked.<BR>2004/02/25 Added a precaution about threads which cannot be checked. <BR> 2004/01/21 Initial version.</P>
38<hr><p>CONFIDENTIAL</p></body>
39</HTML>