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_RequestRawSampling</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">TP_RequestRawSampling <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_RequestRawSampling( TPData * 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 the ARM7 processor the current touch-panel values for a single event and waits until those values are acquired.  The values (which were already checked for chattering) are acquired as uncalibrated, raw values (<I>x</I>- and <I>y</I>-values take the range of 0 to 4095). This command cannot be used during autosampling.</P>
36<P> <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>
37</P>
38<H2>Note</H2>
39<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>
40<h2>See Also</h2>
41<P><A href="TP_RequestCalibratedSampling.html"><CODE>TP_RequestCalibratedSampling</CODE></A><BR> <A href="TP_RequestSamplingAsync.html"><CODE>TP_RequestSamplingAsync</CODE></A></P>
42<H2>Revision History</H2>
43<P>2009/07/22 Deleted duplicate description.<BR> 2004/04/21 Initial version.</P>
44<hr><p>CONFIDENTIAL</p></body>
45</html>
46