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>KPADEnableMpls</title>
8</head>
9
10<body>
11
12<h1>KPADEnableMpls</h1>
13
14<h2>Syntax</h2>
15<dl><dd><pre class="construction">
16#include &lt;revolution/kpad.h&gt;
17
18void KPADEnableMpls( s32 chan, u8 mode );
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>mode</TH>
30      <TD><code>WPAD_MPLS_STD</code>, <code>WPAD_MPLS_FS</code>, or <code>WPAD_MPLS_CL</code>.</TD>
31    </TR>
32  </TBODY>
33</TABLE>
34
35<h2>Return Values</h2>
36<p>
37None.
38</p>
39
40<H2>Description</H2>
41<p>
42Calling this function issues a request that the Wii MotionPlus operate in the operational mode specified by <code>mode</code>. The Wii MotionPlus cannot change operational modes while running. Therefore, if the Wii MotionPlus has already been operating, first change to bypass mode and then change to the specified operational mode. The library attempts to issue an operational-mode-change request if the Wii MotionPlus operational mode differs from the mode specified when data was received from the Wii Remote. If issuing the request fails, the system tries again the next time data is received.
43</p>
44<p>
45The library attempts to issue this request while it is checking the mode of the Wii MotionPlus, so do not call the <a href="../wpad/WPADControlMpls.html"><code>WPADControlMpls</code></a> function directly when using this function.
46</p>
47<br>
48<p><B>Note: The state when HOME Menu is called</B><br>Because the <CODE>KPADEnableMpls</CODE> function continues sending the Start command to the Wii Remote until the Wii MotionPlus enters the specified operating mode, the system will not be able to send any audio output commands to the Wii Remote if the Wii MotionPlus is unplugged while <CODE>KPADEnableMpls</CODE> is executing. Consequently, if you activate the HOME Menu and unplug the Wii MotionPlus while <CODE>KPADEnableMpls</CODE> is executing, the Wii Remote speaker will not be able to output any audio.
49</p>
50
51<p>
52To avoid this problem, be sure to stop the Wii MotionPlus using the <CODE>KPADDisableMpls</CODE> function before activating the HOME Menu.
53</p>
54
55
56<h2>See Also</h2>
57<p class="reference">
58<a href="./KPADDisableMpls.html"><CODE>KPADDisableMpls</CODE></a><BR> <a href="../wpad/WPADControlMpls.html"><CODE>WPADControlMpls</CODE></a><br>
59</p>
60
61<H2>Revision History</H2>
62<p>
632010/06/23 Added text about state where audio output commands cannot be sent to Wii Remote speaker.<br>2008/12/04 Deleted a description of the <code>KPADSetConfig</code> function.<BR>Added <code>WPAD_MPLS_CL</code> as a selection for <SPAN class="argument">mode</SPAN>.<br>2008/07/22 Initial version.
64</p>
65
66<hr><p>CONFIDENTIAL</p></body>
67</html>
68