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 &lt;revolution/dvd.h&gt;</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"><CODE>DVD_STATE_FATAL_ERROR</CODE></TD>
26<TD width="500">A fatal error occurred.</TD>
27    </TR>
28    <TR>
29<TD width="250" bgcolor="#ffffe8"><CODE>DVD_STATE_END</CODE></TD>
30<TD width="500">Request complete or no request.</TD>
31    </TR>
32    <TR>
33<TD width="250" bgcolor="#ffffe8"><CODE>DVD_STATE_BUSY</CODE></TD>
34<TD width="500">The request is currently processing.</TD>
35    </TR>
36    <TR>
37<TD width="250" bgcolor="#ffffe8"><CODE>DVD_STATE_NO_DISK</CODE></TD>
38<TD width="500">No disk in the drive.</TD>
39    </TR>
40    <TR>
41<TD width="250" bgcolor="#ffffe8"><CODE>DVD_STATE_WRONG_DISK</CODE></TD>
42<TD width="500">Wrong disk in the drive.</TD>
43    </TR>
44    <TR>
45<TD bgcolor="#ffffe8"><CODE>DVD_STATE_MOTOR_STOPPED</CODE></TD>
46      <TD width="500">Motor stopped. </TD>
47    </TR>
48    <TR>
49      <TD bgcolor="#ffffe8"><CODE>DVD_STATE_PAUSING</CODE></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"><CODE>DVD_STATE_RETRY</CODE></TD>
54<TD width="500">Retry error occurred.</TD>
55    </TR>
56  </TBODY>
57</TABLE>
58<P><B>Note:</B> The error message <CODE>DVD_STATE_COVER_OPEN</CODE> used in GameCube was deleted. </P>
59<P><B>Note:</B>
60 If the release version of the DVD library is used and the <CODE>DVDFileInfo</CODE> structure is accidently used 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 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>. If no DVD command is currently processing, the <CODE>DVDGetDriveStatus</CODE> function will not return an error even if the player removes the disc.
65</P>
66<P>
67These statuses (no disc, wrong disc, etc.) are returned only if a DVD command is processing, but can&rsquo;t complete because of these statuses.
68</P>
69<H2>See Also</H2>
70<P><A href="DVDGetCommandBlockStatus.html"><CODE>DVDGetCommandBlockStatus</CODE></A></P>
71<H2>Revision History</H2>
72<P>03/01/2006 Initial version.</P>
73</BODY>
74</HTML>