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 http-equiv="Content-Style-Type" content="text/css">
6<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
7<title>KPADSetSamplingCallback</title>
8</head>
9
10<body>
11
12<h1>KPADSetSamplingCallback</h1>
13
14<h2>Syntax</h2>
15<dl><dd><pre class="construction">
16#include &lt;revolution/kpad.h&gt;
17
18void KPADSetSamplingCallback( s32 chan, WPADSamplingCallback callback );
19</pre></dd></dl>
20
21<H2>Arguments</H2>
22<TABLE class="arguments" border="1" >
23  <TBODY>
24    <TR>
25<TH>chan</TH>
26<TD>One of the <code>WPAD_CHAN<i>n</i></code> values.</TD>
27    </TR>
28    <TR>
29<TH>callback</TH>
30<TD>An application sampling callback that is called after the internal sampling callback of the KPAD library is processed.</TD>
31    </TR>
32  </TBODY>
33</TABLE>
34
35<H2>Return Values</H2>
36<P>None.</P>
37
38<H2>Description</H2>
39<p>
40Registers an application sampling callback. If <CODE>NULL</CODE> is specified, the application callback will not be called until reconfiguration.
41</p>
42
43<p>
44In contrast to the KPADOld library, a WPAD library's sampling callback will be used in the KPAD library. For this reason, the application cannot call a <a href="../wpad/WPADSetSamplingCallback.html"><CODE>WPADSetSamplingCallback</CODE></a> function that regulates the WPAD library's sampling callback. Please use this function instead.
45</p>
46
47<p>
48<B>Note:</B> Be aware that the callback registered through this function will not be released unless you either release it by specifying <CODE>NULL</CODE> for this function's argument or call the <a href="./KPADShutdown.html"><code>KPADShutdown</code></a> function. Controller connection/disconnection will not release the callback. (Of course, in the disconnected state, a sampling callback is not called.))
49</p>
50
51<h2>See Also</h2>
52<p class="reference">
53<a href="../wpad/WPADSetSamplingCallback.html">WPADSetSamplingCallback</a>,
54<a href="../kpad/KPADShutdown.html">KPADShutdown</a>
55</p>
56
57<H2>Revision History</H2>
58<p>
592008/04/17 Added the fact that the callback can also be released with the <code>KPADShutdown</code> function.<br>2006/10/25 Initial version. <br>
60</p>
61
62<hr><p>CONFIDENTIAL</p></body>
63</html>
64