Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File4.13.10  Metagettoc                                                TOS

 Name:         »Metagettoc« - Return the table of contents of a 
               device.

 Opcode:       62

 Syntax:       int32_t Metagettoc( int16_t drive, int16_t flag, 
               CD_TOC_ENTRY *buffer );

 Description:  The function returns the table of contents of a drive. 
               The following applies:

                Parameter  Meaning 
                drive      Desired drive 
                flag       Reserved for CDAR504 
                buffer     Buffer for receiving the table of contents 

               Note: The receiving buffer should have room for 128 
               entries. Each entry consists of a track number and an 
               MSF address (both in BCD format). For the track number 
               the following applies:
               0 = Record has no meaning
               0x01...0x99 = Track number in BCD coding
               0xa0 = First track with programmed order 0xa2 = End of 
               the CD.

 Return value: The function returns a value of the type int32_t.

 Availability: This function is only available when MetaDOS has been 
               installed.

 Group:        Drive functions

 See also:     Binding   Metaread   Metawrite