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>OSLaunchDisk</title> 9</head> 10 11<body> 12 13<h1>OSLaunchDiskl<BR>OSLaunchDiskv</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 OSLaunchDiskl(DVDDiskID* <i>diskId</i>, u32 <i>launchCode</i>, const const char* <i>arg0</i>, .../*, (char*)NULL */); 21void OSLaunchDiskv(DVDDiskID* <i>diskId</i>, u32 <i>launchCode</i>, char* const <i>argv[]</i>);</code></pre> 22 </dd> 23</dl> 24<h2>Arguments</h2> 25 26<table border="1" cellpadding="3" cellspacing="0"> 27 <tr> 28<td width="120" bgcolor="#ffffe8"><code><b><i>diskId</i></b></code></td> 29<td width="520">Disc ID of the Disc application you want to run.</td> 30 </tr> 31 <tr> 32<td width="120" bgcolor="#ffffe8"><code><b><i>launchCode</i></b></code></td> 33<td width="520">The launch code that can be passed to the Disc application being run.</td> 34 </tr> 35 <tr> 36<td width="120" bgcolor="#ffffe8"><code><b><i>arg0,...</i></b></code></td> 37<td width="520">((For <code>OSLaunchDiskl</code> only) A list of pointers to zero or more null-terminated strings that make up an argument list that can be passed to the application being run. The list of arguments <I>must</I> be terminated by a null pointer.</td> 38 </tr> 39 <tr> 40<td width="120" bgcolor="#ffffe8"><code><b><i>argv</i></b></code></td> 41<td width="520">((For <code>OSLaunchDiskv</code> only) An array of pointers to zero or more null-terminated strings that make up an argument list that can be passed to the application being run. This array of pointers <I>must</I> be terminated by a null pointer.</td> 42 </tr> 43 44</table> 45 46<h2>Return Values</h2> 47<p>None.</p> 48<h2>Description</h2> 49<P>The <CODE>OSLaunchDiskl</CODE> and <CODE>OSLaunchDiskv</CODE> functions execute a new disc application. If successful, the functions do not return.</P> 50<P>The initial argument for these functions is the Disc ID of the disc application you want to run.</P> 51<P>Before calling either of these functions, use <A href="DVDPrepareDisk.html"><CODE>DVDPrepareDisk</CODE></A> to check that the disc is inserted.</P> 52<P>By calling <A href="OSGetLaunchCode.html"><CODE>OSGetLaunchCode</CODE></A> from the new disc application, you can reference the launch code specified by <B><I><CODE>launchCode</CODE></I></B>.</p> 53<P>The arguments for <CODE>OSLaunchDiskl</CODE> are defined in series as <SPAN class="argument">arg0</SPAN>, <SPAN class="argument">arg1</SPAN>, ..., <SPAN class="argument">argn</SPAN>. Together, these arguments describe a list of pointers to zero or more null-terminated strings that represent the argument list available to the new disc application. The list of arguments <I>must</I> be terminated by a null pointer.</P> 54<P>In the <code>OSLaunchDiskv</code> function, there is an array of pointers to zero or more null-terminated strings that represent the argument list available to the new disc application. This array of pointers <I>must</I> be terminated by a null pointer.</P> 55<P>The <code>OSSetSaveRegion</code> function <I>does not work</I> with the <code>OSLaunchDiskl</code> and <code>OSLaunchDiskv</code> functions.</B></P> 56<P>The controllers are not recalibrated during execution sequences.</P> 57<P>If the game disc cannot be read during an execution sequence for any reason (including no disc, retry error, fatal error, and wrong error), <code>OSLaunchDiskl</code> or <code>OSLaunchDiskv</code> returns execution to the system menu. For this reason, you should save any unsaved data before making the call to <code>OSLaunchDiskl</code> or <code>OSLaunchDiskv</code>.</P> 58 59<h2>See Also</h2> 60<p><a href="DVDPrepareDisk.html"><CODE>DVDPrepareDisk</CODE></a><BR> <a href="OSGetLaunchCode.html"><CODE>OSGetLaunchCode</CODE></a><BR></p> 61<H2>Revision History</H2> 62<P> 632009/10/16 Changed the <CODE>include</CODE> file.<BR>2007/04/20 Initial version. 64</P> 65<hr><p>CONFIDENTIAL</p></body> 66</html>