DVDFileInfo

C Specification

#include <revolution/dvd.h>

typedef struct DVDFileInfo  DVDFileInfo;

struct DVDFileInfo
{
#ifndef MACOS
	DVDCommandBlock cb;
#endif
        ...
}

(All structure members are not listed. For a complete list, look at dvd.h. Do not directly access these members. these are subject to change.)

Description

The DVDFileInfo structure holds file information. It also contains the DVDCommandBlock structure for internal use. For this purpose, the DVDFileInfo structure that is in use (for example, currently transferring or in the DVD queue) can't be used. For more detail, see the DVDCommandBlock function.

If you want to divide one file into two parts and issue a read, open twice using separate DVDFileInfo structures. The following is the best method for implementation.

entrynum = DVDConvertPathToEntrynum(file);
DVDFastOpen(entrynum, fileinfo1);
DVDFastOpen(entrynum, fileinfo2);

Because the first member of the DVDFileInfo structure is guaranteed to be cb, casting a structure allows access to the DVDCommandBlock. For example, to cancel a read request using fileInfo of a DVDFileInfo structure, you can call:

DVDCancel((DVDCommandBlock*)&fileInfo);

See Also

DVDCommandBlock Structure

Revision History

2006/03/01 Initial version.

CONFIDENTIAL