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 8.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>TP_WaitCalibratedResult</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">TP_WaitCalibratedResult <img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD><CODE>#include &lt;nitro/spi.h&gt;</CODE><BR>
15  <PRE><CODE>u32 TP_WaitCalibratedResult( <A href="TPData.html">TPData</A> * result );</CODE></PRE>
16</DL>
17<H2>Arguments</H2>
18<TABLE border="1" width="100%">
19  <TBODY>
20    <TR>
21      <TD width="300"><EM><STRONG><FONT face="Courier New">result</FONT></STRONG></EM></TD>
22      <TD width="700">Pointer to the variable to obtain touch-panel values.</TD>
23    </TR>
24  </TBODY>
25</TABLE>
26<H2>Return Values</H2>
27<P>0 if touch-panel value is obtained successfully.<br>Non-zero value if task fails due to some error.</P>
28<H2>Description</H2>
29<P>This function checks whether the ARM7 has set the touch panel values that were requested using the <CODE><A href="TP_RequestSamplingAsync.html">TP_RequestSamplingAsync</A></CODE> function. It then acquires them as calibrated screen coordinates. (X value ranges between 0 and 255; Y value ranges between 0 and 191) The value obtained here already accounts for chattering. If no response has arrived from ARM7, it will wait internally until there is a response.</P>
30<H2>Note</H2>
31<P><FONT color="#ff0000">If this function is called before a response is received from ARM7, it will use an interrupt to wait for a completion response. Therefore, if it is called while FIFO receive interrupts from ARM7 are prohibited, it may not be possible to return from wait. From within touch panel callbacks, call the <CODE><A href="TP_GetCalibratedResult.html">TP_GetCalibratedResult</A></CODE> function.<BR></FONT></P>
32<H2>See Also</H2>
33<P><CODE><A href="TP_RequestSamplingAsync.html">TP_RequestSamplingAsync</A>, <A href="TP_GetCalibratedResult.html">TP_GetCalibratedResult</A>, <A href="TP_WaitRawResult.html">TP_WaitRawResult</A>, <A href="TPData.html">TPData</A></CODE></P>
34<H2>Revision History</H2>
35<P>2004/04/16 Initial version.</P>
36<hr><p>CONFIDENTIAL</p></body>
37</HTML>