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.11.20  Dsp_LoadProg                                              TOS

 Name:         »Dsp_LoadProg« - DSP Programm laden und starten

 Xbiosnummer:  108

 Deklaration:  int16_t Dsp_LoadProg( int8_t *file, int16_t ability, 
               int8_t *buffer );

 Beschreibung: Die Funktion Dsp_LoadProg lädt das DSP-Programm mit dem 
               Namen file. Das Programm muß im .LOD-Format vorliegen 
               und darf den durch Dsp_Reserve reservierten Speicher 
               nicht überschreiten. Der Parameter ability 
               identifiziert das Programm. buffer zeigt auf einen 
               Speicherbereich, in dem das generierte Programm 
               zwischengespeichert werden kann. Die Größe des 
               Speicherbereichs berechnet sich nach der Formel

               DSP-Wortgröße *
               ( Anzahl der Programm- und Datenworte in der .LOD-Datei +
               ( DSP-Wortgröße * Anzahl der Blöcke in der .LOD-Datei ))

               Danach wird das Programm ausgeführt.

 Ergebnis:     Die Funktion liefert im positiven Fall den Wert 0, und 
               im Fehlerfall den Wert -1 zurück.

 Verfügbar:    Die Funktion ist nur auf Computern mit dem 
               Signalprozessor DSP56001 verfügbar.

 Gruppe:       DSP-Programmierung

 Querverweis:  Binding   Dsp_Lock   Dsp_Unlock   Dsp_Available 
               Dsp_Reserve   Dsp_ExecProg   Dsp_ExecBoot 
               Dsp_LodToBinary