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><CODE>DVDOpen</CODE></TITLE> 9</HEAD> 10<BODY> 11<H1>DVDOpen</H1> 12<H2>Syntax</H2> 13<dl><dd><pre class="construction"> 14#include <revolution/dvd.h> 15 16BOOL DVDOpen(const char* fileName, DVDFileInfo* fileInfo); 17</pre></dd></dl> 18 19<H2>Arguments</H2> 20<TABLE class="arguments" border="1" > 21 <TBODY> 22 <TR> 23<TH>fileName</TH> 24<TD>Pointer to file name to open.</TD> 25 </TR> 26 <TR> 27<TH>fileInfo</TH> 28<TD>Pointer to file information to use.</TD> 29 </TR> 30 </TBODY> 31</TABLE> 32 33<H2>Return Values</H2> 34<P>Returns <CODE>TRUE</CODE> if the file exists. Returns <CODE>FALSE</CODE> if it does not exist.</P> 35 36<H2>Description</H2> 37<P>Opens a file.</P> 38<P>The <code>DVDOpen</code> function returns <CODE>FALSE</CODE> if the specified file is not found. To check for a file and then conditionally branch (for example, read and use the file if it exists or use default values if it does not), use the <A href="DVDConvertPathToEntrynum.html"><CODE>DVDConvertPathToEntrynum</CODE></A> function. This is because the <CODE>DVDOpen</CODE> function outputs a warning message if the file is not found.</P> 39<P>The <CODE>DVDOpen</CODE> function is equivalent to combining the <A href="DVDConvertPathToEntrynum.html"><CODE>DVDConvertPathToEntrynum</CODE></A> and <A href="DVDFastOpen.html"><CODE>DVDFastOpen</CODE></A> functions.</P> 40<P><SPAN class="argument">fileName</SPAN> accepts one of the following formats:</P> 41<P> 42<CODE>- /texture/mario</CODE><BR> <CODE>- texture/mario</CODE><BR> 43</P> 44<P>The device driver accepts the first format as the absolute pathname; in contrast, the device driver accepts the second format as the relative pathname from the current directory (see the <A href="DVDChangeDir.html"><CODE>DVDChangeDir</CODE></A> function). There are no restrictions for the file name length.</P> 45<P>Use "/" (forward slash), not "\" (backward slash).</P> 46<P>As with other file systems, you can use ".." and "." to represent the parent and current directories, respectively. The parent directory of the root directory is considered the root directory.</P> 47 48<H2>See Also</H2> 49<P class="reference"> 50<A href="DVDInit.html">DVDInit</A>, 51<A href="DVDClose.html">DVDClose</A>, 52<A href="DVDFastOpen.html">DVDFastOpen</A>, 53<A href="DVDConvertPathToEntrynum.html">DVDConvertPathToEntrynum</A> 54</P> 55 56<H2>Revision History</H2> 57<P> 582006/03/01 Initial version.<BR> 59</P> 60 61<hr><p>CONFIDENTIAL</p></body> 62</HTML> 63