Difference between revisions of "DVDFatal"

From Rare Gaming Dump
(Undo revision 4576 by Tanline666 (talk))
Tag: Undo
(Added proto error message variants)
 
(One intermediate revision by one other user not shown)
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>
 +
 
 +
Earlier versions of the Revolution SDK DVD library used this message instead:
 +
 
 +
<blockquote>"An error has occurred. Turn the power off and refer to the Nintendo Revolution Instruction Booklet for further instructions."</blockquote>
 +
 
 +
This was followed by this variant before the final version:
 +
 
 +
<blockquote>"An error has occurred. Turn the power off and refer to the Instruction Booklet for further instructions."</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]]

Latest revision as of 04:34, 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."

Earlier versions of the Revolution SDK DVD library used this message instead:

"An error has occurred. Turn the power off and refer to the Nintendo Revolution Instruction Booklet for further instructions."

This was followed by this variant before the final version:

"An error has occurred. Turn the power off and refer to the Instruction Booklet for further instructions."

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.