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 17<h2>C Specification</h2> 18 19<dl> 20<dd><pre><code>#include <revolution/dvd.h></code></pre> 21 </dd> 22<dd><pre><CODE> typedef void (*DVDCBCallback)(s32 result, <a href="DVDCommandBlock.html">DVDCommandBlock</a>* block);</CODE></pre> 23 </dd> 24<dd><pre><CODE>BOOL DVDCheckDiskAsync(DVDCommandBlock* block, DVDCBCallback callback);</CODE></pre> 25 </dd> 26</dl> 27 28<h2>Arguments</h2> 29<TABLE border="1" cellpadding="3" cellspacing="0.1"> 30 <tr> 31<TD width="120" bgcolor="#ffffe8"><code><em><strong>block</strong></em></code></TD> 32<TD width="520">Command block of this command.</TD> 33 </tr> 34 <tr> 35<TD width="120" bgcolor="#ffffe8"><code><em><strong>callback</strong></em></code></TD> 36<TD width="520">Callback function to indicate completion.</TD> 37 </tr> 38 </TABLE> 39<h2>Return Values</h2> 40 41<p>Returns TRUE if the command completes normally; otherwise, returns FALSE.</p> 42 43<H2>Description</H2> 44<P>The <code>DVDCheckDiskAsync</code> function checks if the disc is identified.</P> 45<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 the disc in the drive is the correct disc.</P> 46<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 identified. If the return code is <code>END</code>, the <code>DVDCheckDiskAsync</code> function checks the disc status and determines whether the disc is identified.</P> 47 48<P>After the process finishes, the function specified by <em><code><STRONG>callback</STRONG></code></em> is called (unless <CODE>NULL</CODE> is specified). If the Game Disc is successfully identified, 1 is returned in <em><code><STRONG>result</STRONG></code></em> (the first argument) of the <em><code><STRONG>callback</STRONG></code></em> function. 0 is returned if the disc is not identified. The second argument of the <em><code><STRONG>callback</STRONG></code></em> is the same <code><a href="DVDCommandBlock.html">DVDCommandBlock</a></code> structure as when the <code>DVDCheckDiskAsync</code> function is called.</P> 49 50<h2>See Also</h2> 51 52<p><a href="DVDGetDriveStatus.html"><code>DVDGetDriveStatus</code></a></p> 53<H2>Revision History</H2> 54<P>06/07/2006 Initial version.</P> 55</body> 56</html> 57