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=utf-8">
5<META http-equiv="Content-Style-Type" content="text/css">
6<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
7<title>KPADSetControlMplsCallback</title>
8</head>
9
10<body>
11
12<h1>KPADSetControlMplsCallback</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_MPLS_FAILED_CL  -3
19#define KPAD_STATE_CTRL_MPLS_FAILED_FS  -2
20#define KPAD_STATE_CTRL_MPLS_FAILED_EXP         -2
21#define KPAD_STATE_CTRL_MPLS_FAILED_STD         -1
22#define KPAD_STATE_CTRL_MPLS_START               0
23#define KPAD_STATE_CTRL_MPLS_FINISHED            1
24
25typedef void (* KPADControlMplsCallback )( s32 chan, s32 reason );
26
27void KPADSetControlMplsCallback( s32 chan, KPADControlMplsCallback callback );
28</pre></dd></dl>
29
30<H2>Arguments</H2>
31<TABLE class="arguments" border="1" >
32  <TBODY>
33    <TR>
34      <TH>chan</TH>
35      <TD>One of the <code>WPAD_CHAN<i>n</i></code> values.</TD>
36    </TR>
37    <TR>
38      <TH>callback</TH>
39      <TD>The callback that sends notification when the Wii MotionPlus is configured within the KPAD library.</TD>
40    </TR>
41  </TBODY>
42</TABLE>
43
44<H2>Return Values</H2>
45<P>None.</P>
46
47<H2>Description</H2>
48<p>
49Registers the callback that sends notification when the Wii MotionPlus is configured within the KPAD library. If <CODE>NULL</CODE> is specified, no notifications are made until the callback is reset.
50</p>
51
52<p>
53WPAD commands are issued during this interval, which may affect playback on the Wii Remote speaker.
54</p>
55
56<ul><li>Values of the callback <SPAN class="argument">reason</SPAN>:</li></ul>
57<table class="argument" border="1">
58<tr>
59<th>KPAD_STATE_CTRL_MPLS_START</th><td>This notification is sent when configuration of the Wii MotionPlus setting is required.</td>
60</tr>
61<tr>
62<th>KPAD_STATE_CTRL_MPLS_FAILED_STD</th><td>This notification is issued in cases such as when the Wii MotionPlus is not plugged into the Wii Remote and <code>WPAD_MPLS_STD</code> has been set using the <a href="./KPADEnableMpls.html"><code>KPADEnableMpls</code></a> function.</td>
63</tr>
64<tr>
65<th>KPAD_STATE_CTRL_MPLS_FAILED_FS</th><td>This notification is issued if processing fails such as when the Wii MotionPlus is not plugged into the Wii Remote and <code>WPAD_MPLS_FS</code> has been set using the <a href="./KPADEnableMpls.html"><code>KPADEnableMpls</code></a> function.</td>
66</tr>
67<tr>
68<th>KPAD_STATE_CTRL_MPLS_FAILED_CL</th><td>This notification is issued if processing fails such as when the Wii MotionPlus is not plugged into the Wii Remote and <code>WPAD_MPLS_CL</code> has been set using the <a href="./KPADEnableMpls.html"><code>KPADEnableMpls</code></a> function.</td>
69</tr>
70<tr>
71<th>KPAD_STATE_CTRL_MPLS_FINISHED</th><td>This notification is sent when configuration finished normally, or when the Wii Remote was disconnected or there was some similar interruption during configuration.</td>
72</tr>
73</table>
74
75<p>
76If configuration of the Wii MotionPlus setting failed, an retry is attempted.
77</p>
78
79<h2>See Also</h2>
80<p class="reference">
81<a href="./KPADEnableMpls.html"><CODE>KPADEnableMpls</CODE></a><BR> <a href="./KPADDisableMpls.html"><CODE>KPADDisableMpls</CODE></a>
82</p>
83
84<H2>Revision History</H2>
85<p>
862008/12/04 Changed <code>KPAD_STATE_CTRL_MPLS_FAILED_EXP</code> to <code>KPAD_STATE_CTRL_MPLS_FAILED_FS</code> and revised the description. Added a description of <code>KPAD_STATE_CTRL_MPLS_FAILED_CL</code>.<br> 2008/07/22 Initial version.
87</p>
88
89<hr><p>CONFIDENTIAL</p></body>
90</html>
91