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>DVDReadDir</title>
10</head>
11
12<body>
13
14<h1>DVDReadDir</h1>
15
16
17<h2>C Specification</h2>
18
19<dl>
20  <dd><pre><code>#include &lt;revolution/dvd.h&gt;</code></pre>
21  </dd>
22<dd><pre><code>BOOL DVDReadDir(DVDDir* dir, DVDDirEntry* dirent);</code></pre>
23  </dd>
24</dl>
25
26<h2>Arguments</h2>
27<TABLE border="1" cellpadding="3" cellspacing="0.1">
28  <tr>
29<TD width="120" bgcolor="#ffffe8"><em><strong><code>dir</code></strong></em></TD>
30<TD width="520">Directory structure associated with the directory to read.</TD>
31    </tr>
32  <tr>
33<TD width="120" bgcolor="#ffffe8"><em><strong><code>dirent</code></strong></em></TD>
34      <TD width="520">Information about the next directory entry.</TD>
35    </tr>
36</TABLE>
37<h2>Return Values</h2>
38
39<p>If the directory is present, returns <CODE>TRUE</CODE>. </p>
40
41<p>If the function reaches the end of the directory or detects an invalid <A href="DVDSeekDir.html"><CODE>DVDSeekDir</CODE></A> operation, returns <CODE>FALSE</CODE>. </p>
42<H2>Description</H2>
43<P>Gets information about the next directory entry. The directory entry is either a directory or a file. If the entry is a directory, <CODE>dirent-&gt;isDir</CODE> is <CODE>TRUE</CODE>. You can call the <code>DVDOpenDir</code> function to open the subdirectory using <CODE>dirent-&gt;name</CODE>. If the entry is a file, <CODE>dirent-&gt;isDir</CODE> is <CODE>FALSE</CODE>. You can also call <code>DVDOpen</code> to open the file using <CODE>dirent-&gt;name</CODE>.</P>
44<P>The <code>DVDReadDir</code> function returns <CODE>FALSE</CODE> when reaching the end of a directory or detecting an invalid <code>DVDSeekDir</code> operation. If there are directory entries, the function returns <CODE>TRUE</CODE> and valid entry information is stored in <STRONG><EM><CODE>dirent</CODE></EM></STRONG>.</P>
45
46<h2>See Also</h2>
47
48<p><code><a href="DVDOpenDir.html">DVDOpenDir</a><BR> <a href="DVDCloseDir.html">DVDCloseDir</a><BR> <a href="DVDSeekDir.html">DVDSeekDir</a><BR> <a href="DVDRewindDir.html">DVDRewindDir</a></code></p>
49<H2>Revision History</H2>
50<P>03/01/2006 Initial version.</P>
51
52</body>
53</html>
54