DVDCheckDiskAsync

C Specification

#include <revolution/dvd.h>

    typedef void (*DVDCBCallback)(s32 result, DVDCommandBlock* block);

BOOL DVDCheckDiskAsync(DVDCommandBlock* block, DVDCBCallback callback);

Arguments

`block`	Command block of this command.
`callback`	Callback function to indicate completion.

Return Values

Returns TRUE if the command completes normally; otherwise, returns FALSE.

Description

The DVDCheckDiskAsync function checks if the disc is 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 the disc in the drive is the correct disc.

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 identified. If the return code is END, the DVDCheckDiskAsync function checks the disc status and determines whether the disc is identified.

After the process finishes, the function specified by callback is called (unless NULL is specified). If the Game Disc is successfully identified, 1 is returned in result (the first argument) of the callback function. 0 is returned if the disc is not identified. The second argument of the callback is the same DVDCommandBlock structure as when the DVDCheckDiskAsync function is called.

Revision History