1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 9<title>DVDIsDiskIdentified</title> 10</head> 11 12<body> 13 14<h1>DVDIsDiskIdentified</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/dvd.h> 19 20BOOL DVDIsDiskIdentified(void); 21</pre></dd></dl> 22 23<h2>Arguments</h2> 24<p>None.</p> 25 26<h2>Return Values</h2> 27<P>Returns <CODE>TRUE</CODE> if the disc has already been identified. Returns <CODE>FALSE</CODE> if it is as yet unidentified.</P> 28 29<H2>Description</H2> 30<P> 31Checks if the disc has been identified. Unlike the <A href="DVDCheckDiskAsync.html"><CODE>DVDCheckDiskAsync</CODE></A> function, results can be obtained even while interrupts are disabled. 32</P> 33<P> 34"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. 35</P> 36<P> 37If there is no currently executing DVD command, <A href="DVDCheckDiskAsync.html"><CODE>DVDCheckDiskAsync</CODE></A> 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. 38</P> 39<P>For example, during the disc identification sequence that follows a player removing the disc, the <A href="DVDGetDriveStatus.html"><CODE>DVDGetDriveStatus</CODE></A> function returns <CODE>BUSY</CODE> 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 <CODE>DVDIsDiskIdentified</CODE> function.</P> 40 41<h2>See Also</h2> 42<p class="reference"> 43<A href="DVDGetDriveStatus.html"><CODE>DVDGetDriveStatus</CODE></A><BR> <A href="DVDCheckDiskAsync.html"><CODE>DVDCheckDiskAsync</CODE></A> 44</p> 45 46<H2>Revision History</H2> 47<P> 482009/01/30 Added a description of "indentified" and "unidentified."<BR> 2009/01/16 Initial version. 49</P> 50 51<hr><p>CONFIDENTIAL</p></body> 52</html> 53