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>KPADSetControlDpdCallback</title>
8</head>
9
10<body>
11
12<h1>KPADSetControlDpdCallback</h1>
13
14<h2>Syntax</h2>
15<dl><dd><pre class="construction">
16#include &lt;revolution/kpad.h&gt;
17
18#define KPAD_STATE_CTRL_DPD_START               0
19#define KPAD_STATE_CTRL_DPD_FINISHED            1
20
21typedef void (* KPADControlDpdCallback )( s32 chan, s32 reason );
22
23void KPADSetControlDpdCallback( s32 chan, KPADControlDpdCallback callback );
24</pre></dd></dl>
25
26<H2>Arguments</H2>
27<TABLE class="arguments" border="1" >
28  <TBODY>
29    <TR>
30<TH>chan</TH>
31<TD>One of the <code>WPAD_CHAN<i>n</i></code> values.</TD>
32    </TR>
33    <TR>
34<TH>callback</TH>
35<TD>The callback used when the Wii Remote DPD is configured inside KPAD.</TD>
36    </TR>
37  </TBODY>
38</TABLE>
39
40<H2>Return Values</H2>
41<P>None.</P>
42
43<H2>Description</H2>
44<p>
45Registers the callback to be used when DPD settings are configured for the Wii Remote inside KPAD. If <CODE>NULL</CODE> is specified, no notifications will be made until reset. Note that registered callbacks will also be released when the <a href="./KPADInit.html"><CODE>KPADInit</CODE></a> function is called.
46</p>
47<p>
48In KPAD, the DPD setting will be changed internally when a controller is connected, an extended controller is swapped and the controller type is changed, and when the DPD enable/disable setting is changed using the <a href="./KPADEnableDPD.html"><code>KPADEnableDPD</code></a> or <a href="./KPADDisableDPD.html"><code>KPADDisableDPD</code></a> function.
49</p>
50
51<p>
52Remote Speaker playback may be affected because the WPAD command will be issued at this time.
53</p>
54
55<p>
56The callback <SPAN class="argument">reason</SPAN> value will receive <code>KPAD_STATE_CTRL_DPD_START</code> when DPD needs to be configured, and <code>KPAD_STATE_CTRL_DPD_FINISHED</code> when the configuration completes normally or the Wii Remote is disconnected during configuration.
57</p>
58
59<p>
60When DPD configuration fails, there will be an internal retry. Once successfully completed, a callback notification will be made for the first time.
61</p>
62
63<h2>See Also</h2>
64<p class="reference">
65<a href="./KPADEnableDPD.html">KPADEnableDPD</a>,
66<a href="./KPADDisableDPD.html">KPADDisableDPD</a>
67</p>
68
69<H2>Revision History</H2>
70<p>
712006/09/23 Initial version.<br>
72</p>
73
74<hr><p>CONFIDENTIAL</p></body>
75</html>
76