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.1  DMAread                                                    TOS

 Name:         »DMA read« - liest einzelne Sektoren von einer DMA- 
               Einheit.

 Xbiosnummer:  42

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

 Beschreibung: Die XBIOS-Routine DMAread liest einzelne oder mehrere 
               Sektoren von einem 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 
               beschreibbar 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   DMAwrite   Floprd   Flopwr   Rwabs