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>DVDFileInfo</title>
10</head>
11
12<body>
13
14<h1>DVDFileInfo</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>typedef struct DVDFileInfo  DVDFileInfo;
23
24struct DVDFileInfo
25{
26#ifndef MACOS
27	<a href="DVDCommandBlock.html">DVDCommandBlock</a> cb;
28#endif
29        ...
30}
31</CODE></pre>
32(All structure members are not listed. For a complete list, look at <CODE>dvd.h</CODE>. Do not directly access these members. these are subject to change.)
33</dd></dl>
34
35<h2>Description</h2>
36
37<P>The <code>DVDFileInfo</code> structure holds file information. It also contains the <a href="DVDCommandBlock.html"><code>DVDCommandBlock</code></a> structure for internal use. For this purpose, the <code>DVDFileInfo</code> structure that is in use (for example, currently transferring or in the DVD queue) can't be used. For more detail, see the <a href="DVDCommandBlock.html"><code>DVDCommandBlock</code></a> function.</P>
38<P>If you want to divide one file into two parts and issue a read, open twice using separate <code>DVDFileInfo</code> structures. The following is the best method for implementation.</P>
39<p><code>entrynum = <a href="DVDConvertPathToEntrynum.html">DVDConvertPathToEntrynum</a>(file);<br> <a href="DVDFastOpen.html">DVDFastOpen</a>(entrynum, fileinfo1);<br> <a href="DVDFastOpen.html">DVDFastOpen</a>(entrynum, fileinfo2);</code></p>
40
41<P>Because the first member of the <code>DVDFileInfo</code> structure is guaranteed to be <CODE>cb</CODE>, casting a structure allows access to the <a href="DVDCommandBlock.html"><code>DVDCommandBlock</code></a>. For example, to cancel a read request using <STRONG><EM><CODE>fileInfo</CODE></EM></STRONG> of a <code>DVDFileInfo</code> structure, you can call:</P>
42<p><code><a href="DVDCancel.html">DVDCancel</a>((<a href="DVDCommandBlock.html">DVDCommandBlock</a>*)&amp;fileInfo);</code></p>
43
44<h2>See Also</h2>
45
46<p><a href="DVDCommandBlock.html"><code>DVDCommandBlock</code></a> Structure</p>
47<H2>Revision History</H2>
48<P>2006/03/01 Initial version.</P>
49<hr>
50<P>CONFIDENTIAL</p>
51</BODY>
52</HTML>
53