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 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 that were already checked for chattering) are acquired as uncalibrated, raw values (x and y values take the range of 0 to 4095). This command cannot be used during autosampling.</P>
36<P> <strong>Note:</strong> This function can obtain touch panel values even during MIC auto sampling. (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.
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><CODE><A href="TP_RequestCalibratedSampling.html">TP_RequestCalibratedSampling</A>, <A href="TP_RequestSamplingAsync.html">TP_RequestSamplingAsync</A></CODE></P>
42<H2>Revision History</H2>
43<P>2004/04/21 Initial version.</P>
44<hr><p>CONFIDENTIAL</p></body>
45</html>
46