DVDSetAutoFatalMessaging

C Specification

#include <revolution/dvd.h>
BOOL DVDSetAutoFatalMessaging(BOOL enable);

Arguments

enable TRUE (default) enables auto fatal message mode. FALSE disables this mode.

Return Values

Returns TRUE if auto fatal message mode was previously enabled, and FALSE if it was disabled.

Description

Changes auto fatal message mode.

If this mode is on, the optical disc device driver handles fatal errors. If a fatal error occurs, the device driver displays the appropriate error message on the TV screen and hangs by calling the OSFatal function. During this time, no program code will execute. In other words, developers don't need to care about fatal error messages.

Depending on the language setting, the appropriate error message is selected from one of the seven languages (English, Japanese, German, French, Spanish, Italian, or Dutch).

Note: Unlike the Dolphin SDK, auto fatal message mode is enabled by default. DVDSetAutoFatalMessaging (FALSE) must be called at the start of applications whenever a developer implements and uses his or her own FATAL error message.

Note that the game program is still responsible for displaying messages for other errors (for example, no disc).

See Also

OSFatal

Revision History

2006/03/01 Initial version
2006/06/07 Changes default settings and changed the description


CONFIDENTIAL