Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File4.13.2  DMAwrite                                                   TOS

 Name:         »DMA write« - schreibt einzelne Sektoren auf eine DMA- 
               Einheit.

 Xbiosnummer:  43

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

 Beschreibung: Die XBIOS-Routine DMAwrite schreibt einzelne oder 
               mehrere Sektoren auf ein ACSI- oder SCSI-Gerät. Es 
               gilt:

                Parameter  Bedeutung

                sector     erste Sektornummer
                count      Anzahl der Sektoren
                buffer     Anfangsadresse im Speicher
                devno      Gerätenummer. Es gilt:
                            0..7:   ACSI-Geräte 
                            8..15:  SCSI-Geräte 

                           Alle anderen Werte sind für zukünftige 
                           Erweiterungen reserviert.

               Hinweis: In vielen Fällen ist es sinnvoller, statt 
               dieser Funktion Rwabs zu verwenden. Der angegebene 
               Speicherbereich muß für die jeweilige Hardware lesbar 
               sein (Stichwort: Fast-RAM-Buffer). SCSI-Geräte werden 
               von dieser Funktion nicht per DMA, sondern per 
               Handshake betrieben.

 Ergebnis:     Die Funktion liefert als Ergebnis eine 0, wenn kein 
               Fehler passiert ist, ansonsten einen Fehlercode.

 Verfügbar:    Diese Funktion steht erst ab TOS 3.* (Atari TT) zur 
               Verfügung.

 Gruppe:       Laufwerksfunktionen

 Querverweis:  Binding   DMAread   Floprd   Flopwr   Rwabs