Optical Disc Drive API Function List

Optical Disc

DVDInit Initializes the optical disc device driver.
DVDOpen Opens a file.
DVDRead Synchronously reads from the opened file.
DVDReadAsync Asynchronously reads from the opened file.
DVDConvertPathToEntrynum Converts a file name to an entry number.
DVDFastOpen Opens a file. Faster than the DVDOpen function if the file entry number is known.
DVDSeek(Async) Asynchronously moves the drive pickup.
DVDClose Closes the File.
DVDGetLength Gets the size of the opened file.
DVDGetStartAddr Gets the start position of the opened file.
DVDGetTransferredSize Returns the number of bytes already transferred in a read request.
DVDSetAutoInvalidation Changes the invalidation mode.
DVDChangeDir Changes the current directory.
DVDGetFSTLocation Gets a pointer to the FST.
DVDRead(Async)Prio Essentially the same as the DVDReadAsync function except for specifying the queue used for a read request.
DVDSeek(Async)Prio Essentially the same as the DVDSeekAsync function except for specifying the queue used for the seek request.

Directory Access Functions

DVDOpenDir Opens a directory.
DVDFastOpenDir If the entry number of the directory you want to open is known, this function is faster than the DVDOpenDir function.
DVDReadDir Gets the directory entry information.
DVDCloseDir Closes a directory.
DVDTellDir Returns the current location associated with the directory structure.
DVDSeekDir Sets the position of the next DVDReadDir operation in the directory structure.
DVDRewindDir Resets the position of a specified directory structure to the start of the directory.

Priority Control

DVDCancel(Async) Cancels the issued optical disc drive command.
DVDCancelAll(Async) Cancels all optical disc drive commands in the optical disc drive queue as well as the current executing command.
DVDPause Tells the optical disc device driver not to advance to the next request in the queue after the current operation completes.
DVDResume When the optical disc device driver was paused by the DVDPause function, this function tells the optical disc device driver to resume processing commands in the queue.
DVDDumpWaitingQueue Dumps the current queue status.

User Data Access

DVDGetUserData Macro that obtains user data in the block.
DVDSetUserData Macro that sets member data.

Disc Management

DVDGetCurrentDiskID Returns a pointer to the ID of the current disc.
DVDGenerateDiskID A utility function to generate disc IDs.
DVDCompareDiskID A utility function to compare disc IDs.
DVDChangeDisk Waits until changed to the disc with the specified ID.

Error Processing

DVDGetFileInfoStatus Gets the fileinfo structure status.
DVDGetCommandBlockStatus Checks the command block status.
DVDGetDriveStatus Gets the current status of the optical disc drive.
DVDSetAutoFatalMessaging Changes auto fatal message mode.

Structures

DVDCommandBlock Used by the optical disc drive library for management.
DVDFileInfo Structure for storing file information.

Reset Processing Support

DVDCheckDiskAsync Checks if the disk is identified.

Removed functions

DVDCheckDisk


CONFIDENTIAL