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.2  DMAwrite                                                   TOS

 Name:         »DMA write« - Write individual sectors to a DMA device.

 Opcode:       43

 Syntax:       int16_t DMAwrite( int32_t sector, int16_t count, void 
               *buffer, int16_t devno );

 Description:  The XBIOS routine DMAwrite writes single or multiple 
               sectors to an ACSI or SCSI device. The following apply:

                Parameter  Meaning

                sector     First sector number to read
                count      Number of sectors to read
                buffer     Start address in memory where data stored
                devno      Device number. This can be:
                            0..7:   ACSI device 
                            8..15:  SCSI device 

                           All other values are reserved for future 
                           extensions.

               Note: In many cases it is more sensible to use Rwabs in 
               place of this function. The specified memory block must 
               be capable of being read from for the hardware used 
               (catchword: Fast-RAM buffer). SCSI devices are operated 
               by this function not via DMA but via handshaking.

 Return value: The function returns 0 if the operation was successful 
               and no error occurred, else a negative error-code.

 Availability: This function is only available from TOS 3.* (Atari 
               TT030). onwards.

 Group:        Drive functions

 See also:     Binding   DMAread   Floprd   Flopwr   Rwabs