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_CalcCallTraceLines</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">OS_CalcCallTraceLines <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>
15  <BR>
16  <CODE>int OS_CalcCallTraceLines( u32 size );</CODE>
17</DL>
18<H2>Arguments</H2>
19<TABLE border="1" width="100%">
20  <TBODY>
21    <TR>
22      <TD width="13%"><EM><STRONG>size</STRONG></EM></TD>
23      <TD width="87%">Buffer size</TD>
24    </TR>
25  </TBODY>
26</TABLE>
27<H2>Return Values</H2>
28<P>The number of lines that can be reserved. 0 indicates that none can be reserved.</P>
29<H2>Description</H2>
30<P>Gets how many lines of function call trace information can be reserved in a buffer of a specified size.</P>
31<P><B><I>size</I></B> has the same meaning as the value that is specified as the buffer size in <CODE><A href="OS_InitCallTrace.html">OS_InitCallTrace</A></CODE>. In addition to function call trace information, a region for recording a buffer terminator, current pointer, and the like also takes up space in the buffer. This function considers this type of information and obtains the number of lines of trace information that can be reserved in the specified buffer size.</P>
32<P>If this function is compiled for debugging, it will function properly. However, if compiled for the final ROM version (FINALROM) library, it will always return 0.</P>
33<H2>See Also</H2>
34<P><CODE><A href="OS_InitCallTrace.html">OS_InitCallTrace</A>, <A href="OS_CalcCallTraceBufferSize.html">OS_CalcCallTraceBufferSize</A><BR></CODE></P>
35<H2>Revision History</H2>
36<P>2004/04/22 Initial version.</P>
37<hr><p>CONFIDENTIAL</p></body>
38</HTML>