1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>TP_RequestCalibratedSampling</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">TP_RequestCalibratedSampling <img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/spi.h&gt;</CODE><BR>
20  <PRE><CODE>u32 TP_RequestCalibratedSampling( <A href="TPData.html">TPData</A> * result );</CODE></PRE>
21  </dd>
22</dl>
23<h2>Arguments</h2>
24<TABLE border="1" width="100%">
25  <TBODY>
26    <TR>
27      <TD width="300"><em><strong><font face="Courier New">result</font></strong></em></TD>
28      <TD width="700">Pointer to the variable to obtain touch-panel values.</TD>
29    </TR>
30  </TBODY>
31</TABLE>
32<h2>Return Values</h2>
33<P>Returns 0 if the request succeeds; returns non-zero value if it fails.</P>
34<H2>Description</H2>
35<P>This synchronous function requests from ARM7 processor the current touch panel values for a single event and waits until those values are acquired.  The values (values for which chattering measures have already been taken) are acquired as calibrated screen coordinates. (x value takes the range of 0 &ndash; 255, and y value takes 0 &ndash; 191). This command cannot be used during TP autosampling. Even during MIC auto sampling, this function can be used to obtain the touch panel value. (TP auto sampling is not permitted.) However, this function is executed the next time the microphone sampling ends. Therefore, may take longer than usual for the function to respond.
36</P>
37<H2>Note</H2>
38<P>This function uses an interrupt to wait for a completion response from ARM7. Notice that if it is called while FIFO receive interrupts from ARM7 are prohibited, it will not be possible to return from wait.</P>
39<h2>See Also</h2>
40<P><CODE><A href="TP_RequestRawSampling.html">TP_RequestRawSampling</A>, <A href="TP_RequestSamplingAsync.html">TP_RequestSamplingAsync</A>, <A href="TPData.html">TPData</A></CODE></P>
41<H2>Revision History</H2>
42<P>2004/04/21 Initial version.</P>
43<hr><p>CONFIDENTIAL</p></body>
44</html>
45