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>DVDConvertPathToEntrynum</title>
10</head>
11
12<body>
13
14<h1>DVDConvertPathToEntrynum</h1>
15
16
17<h2>C Specification</h2>
18<BLOCKQUOTE>
19<pre><code>#include &lt;revolution/dvd.h&gt;
20
21s32 DVDConvertPathToEntrynum(const char* fileName);</CODE></pre>
22</BLOCKQUOTE>
23<h2>Arguments</h2>
24<TABLE border="1" cellpadding="3" cellspacing="0.1">
25  <tr>
26<TD width="120" bgcolor="#ffffe8"><em><strong><code>fileName</code></strong></em></TD>
27      <TD width="520">Pointer to file name to convert. </TD>
28    </tr>
29</TABLE>
30<h2>Return Values</h2>
31
32<p>Returns the entry number if the files is found and returns -1 if the files is not found.</p>
33<H2>Description</H2>
34<P>Converts a file name to an entry number. The entry number is a unique number assigned to a file. Once an entry number is obtained for a file, you can call the <a href="DVDFastOpen.html"><code>DVDFastOpen</code></a> function which is faster than the <a href="DVDOpen.html"><code>DVDOpen</code></a> function to open the file.</P>
35<P>This function can also check if files exist. If <STRONG><code><em>fileName</em></code></STRONG> doesn't exist, you can check for the file easily because the <code>DVDConvertPathToEntrynum</code> function returns -1. Using the <a href="DVDOpen.html"><code>DVDOpen</code></a> function for this purpose isn't a good method. Because the <a href="DVDOpen.html"><code>DVDOpen</code></a> function displays a warning message if the specified file doesn't exist. Even if <STRONG><code><em>fileName</em></code></STRONG> doesn't exist, the <code>DVDConvertPathToEntrynum</code> function won't display anything.</P>
36<P>Because the <code>DVDConvertPathToEntrynum</code> function returns a unique entry number, you can use the number for your own purposes (for example, a file ID to manage your own file cache system). Note that this number can change with the next <CODE>ndrun</CODE> (especially after you add/delete/move files or change the disc layout).</P>
37
38<h2>See Also</h2>
39
40<p><a href="DVDFastOpen.html"><code>DVDFastOpen</code></a></p>
41<H2>Revision History</H2>
42<P>2006/03/01 Initial version.</P>
43<hr>
44<P>CONFIDENTIAL</p>
45</BODY>
46</HTML>
47