3.3 Die Gerätefunktionen des BOS Treibers

Die Funktionen in der <META_BOS_FUNCTIONS> Struktur sind diejenigen, die ein Programm per Xbios Aufruf mit den Opcodes 0x30 bis 0x3f über MetaDOS aufruft. Sämtliche Funktionen bekommen in A0 die Adresse der <META_BOS_HEADER> Struktur übergeben, die von der gerätespezifischen Initialisierungsfunktion geliefert wurde. Sämtliche weiteren Parameter, die ein Aufrufer an das XBIOS übergibt, werden über den Stack nach C Konvention übergeben. Die Funktion liefert in D0 im Fehlerfall einen negativen Wert bzw. 0, wenn kein Fehler aufgetreten ist. Da Parameter sowohl auf dem Stack als auch per Register übergeben werden, müssen diese Funktionen in Assembler realisiert werden bzw. einen Wrapper in Assembler haben. Eine Funktion, die nicht unterstützt wird, muß EINVFN (-32) zurückliefern.

Positionen auf der CD können auf zwei verschiedene Arten beschrieben werden. Die Datenfunktionen verwenden die LBA (Logical Block Address), was einer Sektornumemr auf Festplatten entspricht. Die LBA's beginnen bei 0 und sind fortlaufend durchnummeriert. Die Audiofunktionen verwenden MSF Adressen. Eine MSF Adresse besteht aus Minute, Sekunde und Frame. Eien Sekunde hat 74 Frames. Der erste Block (LBA 0) hat die MSF Adresse 00:02:00.

• 3.3.1 long (*init)(META_INFO_1 *metainit)
• 3.3.2 long (*open)(META_DRVINFO *metaopen)
• 3.3.3 long (*close)(void)
• 3.3.4 long (*read)(void *buffer, unsigned long first, unsigned short count)
• 3.3.5 long (*write)(void *buffer, unsigned long first, unsigned short count)
• 3.3.6 long (*seek)(unsigned long offset)
• 3.3.7 long (*status)(META_BOS_STATUS *extended)
• 3.3.8 long (*ioctl)(unsigned long magic, unsigned short opcode, void *buffer)
• 3.3.8.1 Opcode für Metaioctl
• 3.3.9 long (*startaudio)(unsigned short flag, unsigned char *tracks)
• 3.3.10 long (*stopaudio)(void)
• 3.3.11 long (*setsongtime)(unsigned short dummy, unsigned long start, unsigned long end)
• 3.3.12 long (*gettoc)(unsigned short dummy, CD_TOC_ENTRY *tocentry)
• 3.3.13 long (*discinfo)(CD_DISC_INFO *discinfo)

English version not yet available.