OSLaunchDiskl
OSLaunchDiskv

Syntax

#include <revolution/discnand.h>
void OSLaunchDiskl(DVDDiskID* diskId, u32 launchCode, const const char* arg0, .../*, (char*)NULL */);
void OSLaunchDiskv(DVDDiskID* diskId, u32 launchCode, char* const argv[]);

Arguments

diskId Disc ID of the Disc application you want to run.
launchCode The launch code that can be passed to the Disc application being run.
arg0,... ((For OSLaunchDiskl 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 must be terminated by a null pointer.
argv ((For OSLaunchDiskv 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 must be terminated by a null pointer.

Return Values

None.

Description

The OSLaunchDiskl and OSLaunchDiskv functions execute a new disc application. If successful, the functions do not return.

The initial argument for these functions is the Disc ID of the disc application you want to run.

Before calling either of these functions, use DVDPrepareDisk to check that the disc is inserted.

By calling OSGetLaunchCode from the new disc application, you can reference the launch code specified by launchCode.

The arguments for OSLaunchDiskl are defined in series as arg0, arg1, ..., argn. 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 must be terminated by a null pointer.

In the OSLaunchDiskv 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 must be terminated by a null pointer.

The OSSetSaveRegion function does not work with the OSLaunchDiskl and OSLaunchDiskv functions.

The controllers are not recalibrated during execution sequences.

If the game disc cannot be read during an execution sequence for any reason (including no disc, retry error, fatal error, and wrong error), OSLaunchDiskl or OSLaunchDiskv returns execution to the system menu. For this reason, you should save any unsaved data before making the call to OSLaunchDiskl or OSLaunchDiskv.

See Also

DVDPrepareDisk
OSGetLaunchCode

Revision History

2009/10/16 Changed the include file.
2007/04/20 Initial version.


CONFIDENTIAL