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<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/dvd.h&gt;
19
20typedef struct DVDFileInfo  DVDFileInfo;
21
22struct DVDFileInfo
23{
24#ifndef MACOS
25	<a href="DVDCommandBlock.html">DVDCommandBlock</a> cb;
26#endif
27        ...
28}
29</pre>
30Not all structure members are listed. For a complete list, see <CODE>dvd.h</CODE>. Do not directly access these members: they are subject to change.)
31</dd></dl>
32
33<h2>Description</h2>
34<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 being transferred or in the DVD queue) must not be used. For more detail, see <A href="DVDCommandBlock.html"><CODE>DVDCommandBlock</CODE></A>.</P>
35<P>To divide a file into two parts and to issue a read, open the file twice using separate <CODE>DVDFileInfo</CODE> structures. The best method for implementation is as follows:</P>
36<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>
37
38<P>Because the first member of the <CODE>DVDFileInfo</CODE> structure is guaranteed to be <CODE>cb</CODE> (<A href="DVDCommandBlock.html"><CODE>DVDCommandBlock</CODE></A>), simply casting a structure allows access to the <A href="DVDCommandBlock.html"><CODE>DVDCommandBlock</CODE></A> structure. For example, to cancel a read request using <SPAN class="argument">fileInfo</SPAN> of a <CODE>DVDFileInfo</CODE> structure, call</P>
39<p><code><a href="DVDCancel.html">DVDCancel</a>((<a href="DVDCommandBlock.html">DVDCommandBlock</a>*)&amp;fileInfo);</code></p>
40
41<h2>See Also</h2>
42<p class="reference">
43<a href="DVDCommandBlock.html">DVDCommandBlock Structure</a>
44</p>
45
46<H2>Revision History</H2>
47<P>
482006/03/01 Initial version.<BR>
49</P>
50
51<hr><p>CONFIDENTIAL</p></body>
52</html>
53