DVDSetAutoFatalMessaging

Syntax

#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 is enabled and FALSE if it is disabled.

Description

Changes the auto fatal message mode.

If this mode is on, the optical disc device driver will handle fatal errors. If a fatal error occurs, an appropriate error message is displayed on the TV screen and the system immediately hangs by calling the OSFatal function. During this time, no program code will execute. In other words, developers do not need to worry about fatal error messages.

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

Unlike the Dolphin SDK, the auto fatal message mode is enabled by default. DVDSetAutoFatalMessaging(FALSE) must be called at the beginning of an application, when a developer uses a self-implemented fatal error message.

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

Revision History

2006/06/07 Changed default settings and changed Description.
2006/03/01 Initial version.