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
18WPADSamplingCallback 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>Pointer to the most recently registered callback function.</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>
53<a href="../wpad/WPADSetSamplingCallback.html"><CODE>WPADSetSamplingCallback</CODE></a><BR> <a href="../kpad/KPADShutdown.html"><CODE>KPADShutdown</CODE></a>
54</p>
55
56<H2>Revision History</H2>
57<p>
582008/12/15 Changed the return value from <code>void</code> to <code>WPADSamplingCallback</code>.<br>2008/04/17 Added the fact that the callback can also be released with the <code>KPADShutdown</code> function.<br>2006/10/25 Initial version.
59</p>
60
61<hr><p>CONFIDENTIAL</p></body>
62</html>
63