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>KPADSetConnectCallback</title>
8</head>
9
10<body>
11
12<h1>KPADSetConnectCallback</h1>
13
14<h2>Syntax</h2>
15<dl><dd><pre class="construction">
16#include &lt;revolution/kpad.h&gt;
17
18WPADConnectCallback KPADSetConnectCallback( s32 chan, WPADConnectCallback 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>A connection notification callback for applications that is called after the internal connection notification 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 a communication notification callback for applications. If <CODE>NULL</CODE> is specified, the application callback is not called until reconfiguration.
41</p>
42
43<p>
44Unlike the KPADOld library, the KPAD library uses a WPAD library connection notification callback. For this reason, the application cannot call a <a href="../wpad/WPADSetConnectCallback.html"><CODE>WPADSetConnectCallback</CODE></a> function that controls the WPAD library connection notification 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.
49</p>
50
51<h2>See Also</h2>
52<p>
53<a href="../wpad/WPADSetConnectCallback.html"><CODE>WPADSetConnectCallback</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>WPADConnectCallback</code>.<br>2008/04/17 Initial version.
59</p>
60
61<hr><p>CONFIDENTIAL</p></body>
62</html>
63