Difference between revisions of "DVDFatal"

From Rare Gaming Dump
(Undo revision 4576 by Tanline666 (talk))
Tag: Undo
Line 1: Line 1:
The '''DVDFatal''' error occurs when a Wii or GameCube has a fatal error when loading a disc that the console cannot recover from. <code>DVDFatal</code> is the actual function called in the game code in this scenario.
+
'''DVDFatal''' is the name of a fatal exception that is raised when a Wii or GameCube fails to read the game disc and cannot recover from the resulting error. Contrary to popular belief, <code>DVDFatal</code> is merely the internal name of the error handling code, and is not actually a function.
  
When a DVDFatal happens on a Wii, an error with wording similar to, "An error has occurred. Press the Eject button, remove the Game Disc, and turn off the power to the console. Please refer to the Wii Operations Manual for help troubleshooting" will be presented on-screen. The only way to clear the error is to power off the console.
+
In order for the <code>DVDFatal</code> code to be ran, the variable <code>DVDSetAutoFatalMessaging</code> needs to be set to true at the beginning of the program. The variable needs to be set to true manually in the [[Dolphin SDK]], but is set automatically in the [[Revolution SDK]]. When the variable is set to false, custom error handling code would be required to be written. If <code>DVDSetAutoFatalMessaging</code> is set to true, then a message similar to the following message will be displayed on screen.
 +
 
 +
<blockquote>"An error has occurred. Press the Eject Button, remove the Game Disc, and turn off the power to the console. Please refer to the Nintendo GameCube Instruction Booklet/Wii Operations Manual for help troubleshooting."</blockquote>
 +
 
 +
The only way to clear the error is to power off the console, as the code calls <code>OSFatal</code> after drawing the screen, which in turn calls <code>[[PPCHalt]]</code>.
  
 
[[Category:Wii]]
 
[[Category:Wii]]

Revision as of 04:21, 23 May 2023

DVDFatal is the name of a fatal exception that is raised when a Wii or GameCube fails to read the game disc and cannot recover from the resulting error. Contrary to popular belief, DVDFatal is merely the internal name of the error handling code, and is not actually a function.

In order for the DVDFatal code to be ran, the variable DVDSetAutoFatalMessaging needs to be set to true at the beginning of the program. The variable needs to be set to true manually in the Dolphin SDK, but is set automatically in the Revolution SDK. When the variable is set to false, custom error handling code would be required to be written. If DVDSetAutoFatalMessaging is set to true, then a message similar to the following message will be displayed on screen.

"An error has occurred. Press the Eject Button, remove the Game Disc, and turn off the power to the console. Please refer to the Nintendo GameCube Instruction Booklet/Wii Operations Manual for help troubleshooting."

The only way to clear the error is to power off the console, as the code calls OSFatal after drawing the screen, which in turn calls PPCHalt.