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 get 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.<BR> <B>Note:</B> This function can get touch-panel values even during MIC auto sampling.<BR> However, this function is executed the next time the microphone sampling ends. Therefore, it may take longer than usual for the function to respond.<BR>
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><A href="TP_RequestRawSampling.html"><CODE>TP_RequestRawSampling</CODE></A><BR> <A href="TP_RequestSamplingAsync.html"><CODE>TP_RequestSamplingAsync</CODE></A><BR> <A href="TPData.html"><CODE>TPData</CODE></A></P>
41<H2>Revision History</H2>
42<P>2009/07/22 Deleted duplicate description.<BR> 2004/04/21 Initial version.</P>
43<hr><p>CONFIDENTIAL</p></body>
44</html>
45