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>DVDCheckDiskAsync</title> 10</head> 11 12<body> 13 14<h1>DVDCheckDiskAsync</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/dvd.h> 19 20typedef void (*DVDCBCallback)(s32 result, <a href="DVDCommandBlock.html">DVDCommandBlock</a>* block); 21 22BOOL DVDCheckDiskAsync(DVDCommandBlock* block, DVDCBCallback callback); 23</pre></dd></dl> 24 25<h2>Arguments</h2> 26<TABLE class="arguments" border="1" > 27 <tr> 28<TH>block</TH> 29<TD>Command block of this command.</TD> 30 </tr> 31 <tr> 32<TH>callback</TH> 33<TD>Callback function to indicate completion.</TD> 34 </tr> 35</TABLE> 36 37<h2>Return Values</h2> 38<p>Always returns <CODE>TRUE</CODE>.</p> 39 40<H2>Description</H2> 41<P>The <CODE>DVDCheckDiskAsync</CODE> function checks whether the disc has been identified.</P> 42<P>"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.</P> 43<P>For example, the disc is considered unidentified if the current state returned from the <A href="DVDGetDriveStatus.html"><CODE>DVDGetDriveStatus</CODE></A> function is <CODE>NO_DISK</CODE>, <CODE>FATAL_ERROR</CODE>, <CODE>RETRY</CODE>, <CODE>MOTOR_STOPPED</CODE>, or <CODE>WRONG_DISK</CODE>. If the return code is <CODE>BUSY</CODE>, the disc is considered to have been identified. If the return code is <CODE>END</CODE> or <CODE>PAUSING</CODE>, the <code>DVDCheckDiskAsync</code> 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.</P> 44 45<P>After the process finishes, the function specified by <SPAN class="argument">callback</SPAN> is called (unless <CODE>NULL</CODE> is specified). If the Game Disc has been identified, 1 is returned in <SPAN class="argument">result</SPAN> (the first argument) of <SPAN class="argument">callback</SPAN>. Zero is returned if the disc is unidentified. The second argument of the <SPAN class="argument">callback</SPAN> is a <A href="DVDCommandBlock.html"><code>DVDCommandBlock</code></A> structure, the same as that given to the <code>DVDCheckDiskAsync</code> function when it is called.</P> 46 47<h2>See Also</h2> 48<p class="reference"> 49<a href="DVDGetDriveStatus.html">DVDGetDriveStatus</a> 50</p> 51 52<H2>Revision History</H2> 53<P> 542008/06/20 Added an explanation about the value returned immediately after a disc is inserted.<BR>2007/06/28 Revised the description of return values.<BR>2006/06/07 Initial version.<BR> 55</P> 56 57<hr><p>CONFIDENTIAL</p></body> 58</html> 59