1<html>
2
3<head>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="Microsoft FrontPage 5.0">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<title>OSLaunchManualViewer</title>
9</head>
10
11<body>
12
13<h1>OSLaunchManualViewer</h1>
14
15<h2>Syntax</h2>
16
17<dl>
18  <dd><pre><code>void OSLaunchManualViewer(const char* arg);</code></pre>
19  </dd>
20</dl>
21<h2>Arguments</h2>
22
23<table border="1" cellpadding="3" cellspacing="0">
24  <tr>
25<td width="120" bgcolor="#ffffe8"><code><b><i>arg</i></b></code></td>
26<td width="520">Pointer to the text string passed when Manual Viewer is executed. When the application starts after Manual Viewer exits, this text string is passed as the second argument (<CODE><EM>argv[1]</EM></CODE>) to the <CODE>main</CODE> function. The maximum length of this text string is 511 (including NULL terminator).</td>
27  </tr>
28</table>
29
30<h2>Return Values</h2>
31<p>None.</p>
32
33<h2>Description</h2>
34<P>The <CODE>OSLaunchManualViewer</CODE> function executes Manual Viewer saved in Wii console NAND memory. If successful, control does not return from this function.<br>Because execution will move to an entirely separate application (Manual Viewer) when data has to be saved,  always save the data before calling the <code>OSLaunchManualViewer</code> function.<br><br>It is possible to pass a text string (up to 511 characters, including null-termination) as an argument. When the application starts after the Manual Viewer exits, this text string is passed as the second argument to the <code>main</code> function. Because arguments are not passed to the <code>main</code> function when the application is started from the Wii menu, it is possible to use process branching or a similar technique to move to a particular screen when returning from Manual Viewer.<br><br>The <code>OSSetSaveRegion</code> function <b>does not work</b> with the <code>OSLaunchManualViewer</code> function.<br>The controllers will not be recalibrated during an execution sequence.</P>
35<P>When calling this function, keep in mind the precautions in <A HREF="../Reset/intro.html">Reset and Shutdown Functions</A>.</P>
36
37<h2>Note</h2>
38<p><code>OSLaunchManualViewer</code> is a function intended especially for WiiWare.<br> <b><font color="red">It cannot be used with disc applications.</font></b></p>
39
40<h2>See Also</h2>
41<P><a href="../Reset/intro.html">Reset and Shutdown Functions</a></P>
42
43<H2>Revision History</H2>
44<P>
452008/01/15 Added information about the NULL terminator.<br>2007/12/11 Mentioned that this is a WiiWare-specific function.<br>2007/12/05 Initial version.
46</P>
47<hr><p>CONFIDENTIAL</p></body>
48</html>