#include <revolution/dvd.h> BOOL DVDOpen(const char* fileName, DVDFileInfo* fileInfo);
| fileName | Pointer to file name to open. |
|---|---|
| fileInfo | Pointer to file information to use. |
Returns TRUE if the file exists. Returns FALSE if it does not exist.
Opens a file.
The DVDOpen function returns FALSE if the specified file is not found. To check for a file and then conditionally branch (for example, read and use the file if it exists or use default values if it does not), use the DVDConvertPathToEntrynum function. This is because the DVDOpen function outputs a warning message if the file is not found.
The DVDOpen function is equivalent to combining the DVDConvertPathToEntrynum and DVDFastOpen functions.
fileName accepts one of the following formats:
- /texture/mario
- texture/mario
The device driver accepts the first format as the absolute pathname; in contrast, the device driver accepts the second format as the relative pathname from the current directory (see the DVDChangeDir function). There are no restrictions for the file name length.
Use "/" (forward slash), not "\" (backward slash).
As with other file systems, you can use ".." and "." to represent the parent and current directories, respectively. The parent directory of the root directory is considered the root directory.
DVDInit, DVDClose, DVDFastOpen, DVDConvertPathToEntrynum
2006/03/01 Initial version.
CONFIDENTIAL