#include <revolution/dvd.h> typedef void (*DVDCBCallback)(s32 result, DVDCommandBlock* block); BOOL DVDCheckDiskAsync(DVDCommandBlock* block, DVDCBCallback callback);
| block | Command block of this command. |
|---|---|
| callback | Callback function to indicate completion. |
Always returns TRUE.
The DVDCheckDiskAsync function checks whether the disc has been identified.
"Identified" means that the currently inserted disc is the correct disc. "Unidentified" indicates that the user removed the disc and the DVD library cannot verify that correct disc is in the drive.
For example, the disc is considered unidentified if the current state returned from the DVDGetDriveStatus function is NO_DISK, FATAL_ERROR, RETRY, MOTOR_STOPPED, or WRONG_DISK. If the return code is BUSY, the disc is considered to have been identified. If the return code is END or PAUSING, the DVDCheckDiskAsync function checks whether there is a disc. If there is no disc, the function returns "unidentified." If there is a disc, it returns the immediately prior identification status. Note that this function will return "unidentified" immediately after a disc is inserted if no DVD command has yet been executed.
After the process finishes, the function specified by callback is called (unless NULL is specified). If the Game Disc has been identified, 1 is returned in result (the first argument) of callback. Zero is returned if the disc is unidentified. The second argument of the callback is a DVDCommandBlock structure, the same as that given to the DVDCheckDiskAsync function when it is called.
2008/06/20 Added an explanation about the value returned immediately after a disc is inserted.
2007/06/28 Revised the description of return values.
2006/06/07 Initial version.
CONFIDENTIAL