1<html> 2 3<head> 4<META http-equiv="Content-Type" content="text/html; charset=utf-8"> 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>OSLaunchInstaller</title> 9</head> 10 11<body> 12 13<h1>OSLaunchInstaller</h1> 14 15<h2>Syntax</h2> 16 17<dl> 18 <dd><pre><code>#include <revolution/discnand.h></code></pre> 19 </dd> 20 <dd><pre><code>void OSLaunchInstaller(u32 <i>launchCode</i>, u16* <i>gameTitleName</i>, OSInstallInfo* <i>info</i>);</code></pre> 21 </dd> 22</dl> 23<h2>Arguments</h2> 24 25<table border="1" cellpadding="3" cellspacing="0"> 26 <tr> 27<td width="120" bgcolor="#ffffe8"><code><b><i>launchCode</i></b></code></td> 28<td width="520">Launch code that can be referenced once the process has returned from the channel installer.</td> 29 </tr> 30 <tr> 31<td width="120" bgcolor="#ffffe8"><code><b><i>gameTitleName</i></b></code></td> 32<td width="520">Pointer to the character string (UTF-16BE) that indicates the title of the game.</td> 33 </tr> 34 <tr> 35<td width="120" bgcolor="#ffffe8"><code><b><i>info</i></b></code></td> 36<td width="520">Pointer to the array of file information that is passed to the channel installer for installation. <CODE>NULL</CODE> <I>must</I> be assigned to the member that is the final entry of this array.</td> 37 </tr> 38 39</table> 40 41<h2>Return Values</h2> 42<p>None.</p> 43<h2>Description</h2> 44<P>Executes the channel installer. If successful, the function does not return.</P> 45<P>If the installer ends and the process has returned to the application from the channel installer, you can call <A href="OSGetLaunchCode.html"><CODE>OSGetLaunchCode</CODE></A> to reference the launch code specified in <SPAN class="argument">launchCode</SPAN>.</P> 46<P>The <SPAN class="argument">gameTitleName</SPAN> argument specifies the title name of the application that originated the function call. This is used for display purposes inside the channel installer. Characters are encoded in UTF-16BE, which is Revolution's internal character encoding.</P> 47<P>There is no support for <code>OSSetSaveRegion</code>.</P> 48<P>The controllers are not recalibrated during execution sequences.</P> 49<P>The <CODE>OSLaunchInstaller</CODE> function will return execution to the system menu if the game disc cannot be read during an execution sequence for any reason (no disc, retry error, fatal error, wrong error, and so on), or if an non-recoverable error occurs during the installation sequence. For this reason, you should save any unsaved data before making the call to <code>OSLaunchInstaller</code>.</P> 50 51<h2>See Also</h2> 52<p><code><a href="OSGetLaunchCode.html">OSGetLaunchCode</a></code></p> 53 54<H2>Revision History</H2> 55<P> 562009/10/16 Changed the <CODE>include</CODE> file.<BR> 2008/10/30 Revised the text.<BR>2007/04/20 Initial version. 57</P> 58<hr><p>CONFIDENTIAL</p></body> 59</html> 60