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=utf-8"> 5<META name="GENERATOR" content="IBM WebSphere Homepage Builder V6.0.1 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 8<BASE target="main"> 9<TITLE>Optical Disc (DVD) API Function List</TITLE> 10</HEAD> 11<BODY> 12<H1>Optical Disc (DVD) API Function List</H1> 13<H2><a name="Dvd">Optical Disc</a></H2> 14<TABLE class="api_list" border="1"> 15 <TBODY> 16 <TR> 17<TH><A href="DVDInit.html">DVDInit</A></TH> 18<TD>Initializes the optical disc device driver.</TD> 19 </TR> 20 <TR> 21<TH><A href="DVDOpen.html">DVDOpen</A></TH> 22<TD>Opens a file.</TD> 23 </TR> 24 <TR> 25<TH><A href="DVDRead.html">DVDRead</A></TH> 26<TD>Synchronously reads from the opened file.</TD> 27 </TR> 28 <TR> 29<TH><A href="DVDReadAsync.html">DVDReadAsync</A></TH> 30<TD>Asynchronously reads from the opened file.</TD> 31 </TR> 32 <TR> 33<TH><A href="DVDConvertPathToEntrynum.html">DVDConvertPathToEntrynum</A></TH> 34<TD>Converts filename to entry number.</TD> 35 </TR> 36 <TR> 37<TH><A href="DVDConvertEntrynumToPath.html">DVDConvertEntrynumToPath</A></TH> 38<TD>Converts an entry number into a filename.</TD> 39 </TR> 40 <TR> 41<TH><A href="DVDFastOpen.html">DVDFastOpen</A></TH> 42<TD>Opens a file. If the file entry number is known, this function is faster than <CODE>DVDOpen</CODE>.</TD> 43 </TR> 44 <TR> 45<TH><A href="DVDSeek.html">DVDSeek(Async)</A></TH> 46<TD>Asynchronously moves the drive pickup.</TD> 47 </TR> 48 <TR> 49<TH><A href="DVDClose.html">DVDClose</A></TH> 50<TD>Closes the file.</TD> 51 </TR> 52 <TR> 53<TH><A href="DVDGetLength.html">DVDGetLength</A></TH> 54<TD>Gets the size of the opened file.</TD> 55 </TR> 56 <TR> 57<TH><A href="DVDGetStartAddr.html">DVDGetStartAddr</A></TH> 58<TD>Gets the start position of the opened file.</TD> 59 </TR> 60 <TR> 61<TH><A href="DVDGetTransferredSize.html">DVDGetTransferredSize</A></TH> 62<TD>Returns the number of bytes already transferred in a read request.</TD> 63 </TR> 64 <TR> 65<TH><A href="DVDSetAutoInvalidation.html">DVDSetAutoInvalidation</A></TH> 66<TD>Changes invalidation mode.</TD> 67 </TR> 68 <TR> 69<TH><A href="DVDChangeDir.html">DVDChangeDir</A></TH> 70<TD>Changes current directory.</TD> 71 </TR> 72 <TR> 73<TH><A href="DVDGetEntrynum.html">DVDGetEntrynum</A></TH> 74<TD>Gets an entry number.</TD> 75 </TR> 76 <TR> 77<TH><A href="DVDGetEntryName.html">DVDGetEntryName</A></TH> 78<TD>Gets an entry name.</TD> 79 </TR> 80 <TR> 81<TH><A href="DVDEntrynumIsDir.html">DVDEntrynumIsDir</A></TH> 82<TD>Checks whether an entry is a directory.</TD> 83 </TR> 84 <TR> 85<TH><A href="DVDGetFSTLocation.html">DVDGetFSTLocation</A></TH> 86<TD>Gets a pointer to the FST.</TD> 87 </TR> 88 <TR> 89<TH><A href="DVDReadPrio.html">DVDRead(Async)Prio</A></TH> 90<TD>This function is essentially the same as <A href="DVDReadAsync.html"><CODE>DVDReadAsync</CODE></A>, with the exception that it specifies the queue used for a read request.</TD> 91 </TR> 92 <TR> 93<TH><A href="DVDSeekPrio.html">DVDSeek(Async)Prio</A></TH> 94<TD>This function is essentially the same as <A href="DVDSeek.html"><CODE>DVDSeekAsync</CODE></A>, with the exception that it specifies the queue used for the seek request.</TD> 95 </TR> 96 </TBODY> 97</TABLE> 98 99<H2><a name="Directory Access">Directory Access</a></H2> 100<TABLE class="api_list" border="1"> 101 <TBODY> 102 <TR> 103<TH><A href="DVDOpenDir.html">DVDOpenDir</A></TH> 104<TD>Opens a directory.</TD> 105 </TR> 106 <TR> 107<TH><A href="DVDFastOpenDir.html">DVDFastOpenDir</A></TH> 108<TD>If the entry number of the directory you want to open is known, this function is faster than <A href="DVDOpenDir.html"><CODE>DVDOpenDir</CODE></A>.</TD> 109 </TR> 110 <TR> 111<TH><A href="DVDReadDir.html">DVDReadDir</A></TH> 112<TD>Gets the directory entry information.</TD> 113 </TR> 114 <TR> 115<TH><A href="DVDCloseDir.html">DVDCloseDir</A></TH> 116<TD>Closes a directory.</TD> 117 </TR> 118 <TR> 119<TH><A href="DVDTellDir.html">DVDTellDir</A></TH> 120<TD>Returns the current location associated with the directory structure.</TD> 121 </TR> 122 <TR> 123<TH><A href="DVDSeekDir.html">DVDSeekDir</A></TH> 124<TD>Sets the position of the next <CODE>DVDReadDir</CODE> operation in the directory structure.</TD> 125 </TR> 126 <TR> 127<TH><A href="DVDRewindDir.html">DVDRewindDir</A></TH> 128<TD>Resets the position of a specified directory structure to the beginning of the directory.</TD> 129 </TR> 130 131 <TR> 132<TH><A href="DVDGetDirEntrynum.html">DVDGetDirEntrynum</A></TH> 133<TD>Gets the entry number of the directory.</TD> 134 </TR> 135 <TR> 136<TH><A href="DVDGetDirEntryName.html">DVDGetDirEntryName</A></TH> 137<TD>Gets the entry name of the directory.</TD> 138 </TR> 139 <TR> 140<TH><A href="DVDGetDirEntryEntrynum.html">DVDGetDirEntryEntrynum</A></TH> 141<TD>Gets the entry number of the directory entry.</TD> 142 </TR> 143 <TR> 144<TH><A href="DVDDirEntryIsDir.html">DVDDirEntryIsDir</A></TH> 145<TD>Checks whether a directory entry is a directory.</TD> 146 </TR> 147 148 </TBODY> 149</TABLE> 150 151<H2><a name="Priority Control">Priority Control</a></H2> 152<TABLE class="api_list" border="1"> 153 <TBODY> 154 <TR> 155<TH><A href="DVDCancel.html">DVDCancel(Async)</A></TH> 156<TD>Cancels the issued optical disc drive command.</TD> 157 </TR> 158 <TR> 159<TH><A href="DVDCancelAll.html">DVDCancelAll(Async)</A></TH> 160<TD>Cancels the current executing command and all optical disc drive commands in the optical disc drive queue.</TD> 161 </TR> 162 <TR> 163<TH><A href="DVDPause.html">DVDPause</A></TH> 164<TD>Tells the optical disc device driver not to advance to the next request in the queue after the current operation completes.</TD> 165 </TR> 166 <TR> 167<TH><A href="DVDResume.html">DVDResume</A></TH> 168<TD>When the optical disc device driver was paused by <CODE>DVDPause</CODE>, this function tells the optical disc device driver to resume processing commands in the queue.</TD> 169 </TR> 170 <TR> 171<TH><A href="DVDDumpWaitingQueue.html">DVDDumpWaitingQueue</A></TH> 172<TD>Dumps the current queue status.</TD> 173 </TR> 174 </TBODY> 175</TABLE> 176 177<H2><a name="User Data Access">User Data Access</a></H2> 178<TABLE class="api_list" border="1"> 179 <TBODY> 180 <TR> 181<TH><A href="DVDGetUserData.html">DVDGetUserData</A></TH> 182<TD>Macro that obtains user data in the block.</TD> 183 </TR> 184 <TR> 185<TH><A href="DVDSetUserData.html">DVDSetUserData</A></TH> 186<TD>Macro that sets member data.</TD> 187 </TR> 188 </TBODY> 189</TABLE> 190 191<H2><a name="Disk Manage">Disk Management</a></H2> 192<TABLE class="api_list" border="1"> 193 <TBODY> 194 <TR> 195<TH><A href="DVDGetCurrentDiskID.html">DVDGetCurrentDiskID</A></TH> 196<TD>Returns a pointer to the ID of the current disc.</TD> 197 </TR> 198 <TR> 199<TH><A href="DVDGenerateDiskID.html">DVDGenerateDiskID</A></TH> 200<TD>A utility function for generating disc IDs.</TD> 201 </TR> 202 <TR> 203<TH><A href="DVDCompareDiskID.html">DVDCompareDiskID</A></TH> 204<TD>A utility function for comparing disc IDs.</TD> 205 </TR> 206 <TR> 207<TH><A href="DVDChangeDisk.html">DVDChangeDisk</A></TH> 208<TD>Waits until changed to the disc with the specified ID.</TD> 209 </TR> 210 </TBODY> 211</TABLE> 212 213<H2><a name="Error">Error Processing</a></H2> 214<TABLE class="api_list" border="1"> 215 <TBODY> 216 <TR> 217<TH><A href="DVDGetFileInfoStatus.html">DVDGetFileInfoStatus</A></TH> 218<TD>Gets the <CODE>fileinfo</CODE> structure status.</TD> 219 </TR> 220 <TR> 221<TH><A href="DVDGetCommandBlockStatus.html">DVDGetCommandBlockStatus</A></TH> 222<TD>Checks the command block status.</TD> 223 </TR> 224 <TR> 225<TH><A href="DVDGetDriveStatus.html">DVDGetDriveStatus</A></TH> 226<TD>Gets the current status of the optical disc drive.</TD> 227 </TR> 228 <TR> 229<TH><A href="DVDIsDiskIdentified.html">DVDIsDiskIdentified</A></TH> 230<TD>Checks if the disc is identified.</TD> 231 </TR> 232 <TR> 233<TH><A href="DVDSetAutoFatalMessaging.html">DVDSetAutoFatalMessaging</A></TH> 234<TD>Changes the auto fatal message mode.</TD> 235 </TR> 236 </TBODY> 237</TABLE> 238 239<H2><a name="struct">Structures</a></H2> 240<TABLE class="api_list" border="1"> 241 <TBODY> 242 <TR> 243<TH><A href="DVDFileInfo.html">DVDFileInfo</A></TH> 244<TD>Structure for storing file information.</TD> 245 </TR> 246 <TR> 247<TH><A href="DVDCommandBlock.html">DVDCommandBlock</A></TH> 248<TD>Used by the optical disc drive library for management.</TD> 249 </TR> 250 </TBODY> 251</TABLE> 252 253<H2><a name="Reset">Reset Processing Support</a></H2> 254<TABLE class="api_list" border="1"> 255 <TBODY> 256 <TR> 257<TH><A href="DVDCheckDiskAsync.html">DVDCheckDiskAsync</A></TH> 258<TD>Checks if the disk is identified.</TD> 259 </TR> 260 </TBODY> 261</TABLE> 262 263<H2><a name="obsolete">Deprecated Functions</a></H2> 264<TABLE class="api_list" border="1"> 265 <TBODY> 266 <TR> 267<TH><A href="DVDCheckDisk.html"><s>DVDCheckDisk</s></A> (obsolete)</TH> 268<TD>Deprecated.</TD> 269 </TR> 270 </TBODY> 271</TABLE> 272<BR> 273 274<hr><p>CONFIDENTIAL</p></body> 275</HTML>