DVDReadDir

C Specification

#include <revolution/dvd.h>

BOOL DVDReadDir(DVDDir* dir, DVDDirEntry* dirent);

Arguments

`dir`	Directory structure associated with the directory to read.
`dirent`	Information about the next directory entry.

Return Values

If the directory is present, returns TRUE.

If the function reaches the end of the directory or detects an invalid DVDSeekDir operation, returns FALSE.

Description

Gets information about the next directory entry. The directory entry is either a directory or a file. If the entry is a directory, dirent->isDir is TRUE. You can call the DVDOpenDir function to open the subdirectory using dirent->name. If the entry is a file, dirent->isDir is FALSE. You can also call DVDOpen to open the file using dirent->name.

The DVDReadDir function returns FALSE when reaching the end of a directory or detecting an invalid DVDSeekDir operation. If there are directory entries, the function returns TRUE and valid entry information is stored in dirent.

Revision History

2006/03/01 Initial version.