1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 8<TITLE>DVDGetDriveStatus</TITLE> 9</HEAD> 10<BODY> 11<H1>DVDGetDriveStatus</H1> 12<H2>C Specification</H2> 13<DL> 14 <DD> 15<PRE><code>#include <revolution/dvd.h></CODE></PRE> 16 <DD> 17<PRE><CODE>s32 DVDGetDriveStatus(void);</CODE></PRE> 18</DL> 19<H2>Arguments</H2> 20<P>None.</P> 21<H2>Return Values</H2> 22<TABLE border="1" cellpadding="3" cellspacing="0.1"> 23 <TBODY> 24 <TR> 25<TD width="250" bgcolor="#ffffe8"><EM><STRONG><CODE>DVD_STATE_FATAL_ERROR</CODE></STRONG></EM></TD> 26<TD width="500">Fatal error occurred.</TD> 27 </TR> 28 <TR> 29<TD width="250" bgcolor="#ffffe8"><EM><STRONG><CODE>DVD_STATE_END</CODE></STRONG></EM></TD> 30<TD width="500">Request complete or no request.</TD> 31 </TR> 32 <TR> 33<TD width="250" bgcolor="#ffffe8"><EM><STRONG><CODE>DVD_STATE_BUSY</CODE></STRONG></EM></TD> 34<TD width="500">Request is currently processing.</TD> 35 </TR> 36 <TR> 37<TD width="250" bgcolor="#ffffe8"><EM><STRONG><CODE>DVD_STATE_NO_DISK</CODE></STRONG></EM></TD> 38<TD width="500">No disk in the drive.</TD> 39 </TR> 40 <TR> 41<TD width="250" bgcolor="#ffffe8"><EM><STRONG><CODE>DVD_STATE_WRONG_DISK</CODE></STRONG></EM></TD> 42<TD width="500">Wrong disk in the drive.</TD> 43 </TR> 44 <TR> 45<TD bgcolor="#ffffe8"><EM><STRONG><CODE>DVD_STATE_MOTOR_STOPPED</CODE></STRONG></EM></TD> 46<TD width="500">Motor stopped.</TD> 47 </TR> 48 <TR> 49<TD bgcolor="#ffffe8"><EM><STRONG><CODE>DVD_STATE_PAUSING</CODE></STRONG></EM></TD> 50<TD width="500">The device driver is paused using the <A href="DVDPause.html"><CODE>DVDPause</CODE></A> function.</TD> 51 </TR> 52 <TR> 53<TD bgcolor="#ffffe8"><EM><STRONG><CODE>DVD_STATE_RETRY</CODE></STRONG></EM></TD> 54<TD width="500">Retry error occurred.</TD> 55 </TR> 56 </TBODY> 57</TABLE> 58<P><strong>Note:</strong> Controller input wait state will not be supported in the near term.</P> 59<P><B>Note:</B> The error message <CODE>DVD_STATE_COVER_OPEN</CODE> used in GameCube was deleted.</P> 60<P><B><I>Note: </I></B> When using the release version of the DVD library, if the <CODE>DVDFileInfo</CODE> structure is used mistakenly in a program, <code>DVD_STATE_WAITING</code> may be returned. This situation can occur if the <CODE>DVDFileInfo</CODE> structure is reused in a new DVD command similar to the current DVD transfer. In the debug version of the library, this case causes an assert error.</P> 61<H2>Description</H2> 62<P>Gets the current status of the optical disc drive. In the case that a DVD request is currently executing, this function is the same as specifying the command block of this request using the <CODE><A href="DVDGetCommandBlockStatus.html">DVDGetCommandBlockStatus</A></CODE> function. Depending on the pause state of the device driver and if no outstanding requests exist, the <code>DVDGetDriveStatus</code> function returns <code>DVD_STATE_END</code> or <code>DVD_STATE_PAUSING</code>. For more information about the pause state, see the <a href="DVDPause.html"><code>DVDPause</code></a> function.</P> 63<P>If this function is called in a callback, it returns <code>DVD_STATE_END</code> even if requests exist in the queue. This return code is returned because the previous request has completed processing but the next request in the queue has not yet started processing.</P> 64<P>If no DVD command is processing, this function returns <code>DVD_STATE_END</code> or <code>DVD_STATE_PAUSING</code>. This has the following meaning.</P> 65<UL> 66<LI>If there is no currently executing DVD command, <CODE>DVDGetDriveStatus</CODE> will not return an error, even if the player removes the disk. 67</UL> 68<P>These statuses (no disc, wrong disc, etc.) are returned only if a DVD command is processing, but cannot complete because of these statuses.</P> 69<H2>See Also</H2> 70<P><A href="DVDGetCommandBlockStatus.html"><CODE>DVDGetCommandBlockStatus</CODE></A></P> 71<H2>Revision History</H2> 72<P>2006/09/19 Removed the description of DVD_STATE_NO_INPUT.<BR>2006/09/07 Added description of DVD_STATE_NO_INPUT.<BR>2006/03/01 Initial version.</P> 73<hr> 74<P>CONFIDENTIAL</p> 75</BODY> 76</HTML>