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.14  Metaread                                                  TOS

 Name:         »Metaread« - Read data from a MetaDOS device.

 Opcode:       51

 Syntax:       int32_t Metaread( int16_t drive, void *buffer, int32_t 
               blockno, int16_t count );

 Description:  The function reads data from a MetaDOS device. The 
               following apply:

                Parameter  Meaning

                drive      Desired drive
                buffer     Buffer for receiving the data
                blockno    Number of the start block
                count      Number of blocks to be read

               Note: The block size for CD-ROMs is 2048 bytes; but 
               unfortunately this can not be obtained in each case. 
               Due to a limitation in Atari's BOS drivers, a maximum 
               of 63 blocks can be read at a time.

 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   Metawrite