DVDIsDiskIdentified

Syntax

#include <revolution/dvd.h>

BOOL DVDIsDiskIdentified(void);

Arguments

None.

Return Values

Returns TRUE if the disc has already been identified. Returns FALSE if it is as yet unidentified.

Description

Checks if the disc has been identified. Unlike the DVDCheckDiskAsync function, results can be obtained even while interrupts are disabled.

"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.

If there is no currently executing DVD command, DVDCheckDiskAsync does not return "unidentified" even if the player removes the disc. Note that the correct status is returned only while a DVD command is executing.

For example, during the disc identification sequence that follows a player removing the disc, the DVDGetDriveStatus function returns BUSY even before disc identification. It is therefore impossible to know if the disc has actually been identified. However, disc identification status can be obtained by simultaneously using the DVDIsDiskIdentified function.

See Also

DVDGetDriveStatus
DVDCheckDiskAsync

Revision History

2009/01/30 Added a description of "indentified" and "unidentified."
2009/01/16 Initial version.


CONFIDENTIAL