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-File3.1.12  Rwabs                                                      TOS

 Name:         Read/write absolute

 Opcode:       4

 Syntax:       int32_t Rwabs ( int16_t rwflag, VOID *buff, int16_t 
               cnt, int16_t recnr, int16_t dev, int32_t lrecno );

 Description:  The BIOS routine Rwabs reads or writes data directly 
               resp. from or to the drive that was specified with dev. 
               The parameter rwflag is a bit-vector that specifies the 
               type of operation. Valid are:

                rwflag-Bit  Meaning

                0           0 = Read
                            1 = Write

                1           0 = Pay regard to media change
                            1 = Do not read of affect media-change 
                            status

                2           0 = In case of error, start a retry
                            1 = Do not start a retry
                            For this, a hard disk driver that is 
                            compatible with AHDI 3.0 is required.

                3           0 = Normal mode
                            1 = Physical mode (1)
                            For this, a hard disk driver that is 
                            compatible with AHDI 3.0 is required.

               cnt characters from buffer buff will be transferred In 
               recnr the starting sector on the drive will be 
               specified. lrecno will be used only if recnr has the 
               value -1, and an AHDI 3.0-compatible hard disk driver 
               is available.

 Return value: The function returns 0 if the access was successful, 
               otherwise a negative number.

 Availability: All TOS versions.

 See also:     Binding