How To Emulate Errors - Nintendo GameCube Manuallines

Hide thumbs Also See for GameCube:

Table of Contents

Optical Disc Drive Guidelines

If the function DVDPrepareStream is called, and if the game player opens the Disc Cover after audio

streaming has begun, audio streaming will be halted. However, even if the game player closes the

Disc Cover at this point, be aware that audio streaming will not restart. Additionally, there is no way to

know if the Disc Cover is open or not at this point (the function DVDGetDriveStatus will not return a

Disc Cover open error). In order to detect if the Disc Cover has been opened during audio streaming,

the best way is to periodically call a DVD function (i.e.- the function DVDGetStreamErrorStatus).

The function DVDGetStreamErrorStatus waits internally until a normal end or a fatal error occurs,

as does the function DVDRead. Therefore it is possible to acquire a Disc Cover open or No disk status

with the function DVDGetDriveStatus

The DTK library is set up to run DVDGetStreamErrorStatus once a second by default.

When you want to resume the track, first check if the function DVDGetStreamErrorStatus is in

Disc Cover close wait state. If it is, you have to call the function DVDPrepareStream again, after the

end of the function DVDGetStreamErrorStatus. However, you cannot tell at what point the Game

Disc was being played when the Disc Cover was opened (although to a certain extent it is possible to

tell at what point the Game Disc was being played last by periodically polling the function

DVDGetStreamPlayAddr). The most a developer can do at this point is to start playing from the

beginning of the song.

3.7 How to Emulate Errors

During development, it is very important to make sure the game can handle errors properly (i.e. can

show proper message on the TV). You will be able to use the Game Disc emulator (DDH/GDEV) to

emulate all kinds of errors, including wrong Game Disc error, retry error and fatal error.

Currently, DDH and NPDP-GDEV have the following emulation capabilities.

Emulation possible on DDH:

We are planning to be able to emulate all errors since AMCDDK Version. 3.0.2 patch #2. Please see

the AMCDDK manual for more details.

NPDP-GDEV:

With Version 1.01 or later, all errors can be emulated. Please see the NPDP-GDEV manual for more

details.

DOL-06-0026-001-A5

Released: 4/18/02

Table of Contents