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

 Name:         »Dsp_LoadProg« - Load and execute DSP program

 Opcode:       108

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

 Description:  The function Dsp_LoadProg loads the DSP program with 
               the name file from disk. The program must be in the 
               .LOD format and must not exceed the memory space 
               reserved by Dsp_Reserve. The parameter ability 
               identifies the program. buffer points to a memory block 
               where the DSP can place the binary code it generates 
               for the time being. The size of the memory block can be 
               calculated with the formula:

               DSP-wordsize *( Number of program
               and data words in the LOD file +
               ( DSP-wordsize * Number of blocks
               in the .LOD file ))

               After this the program will be executed.

 Return value: The function returns the value 0 if successful, or -1 
               in case of error.

 Availability: The function is available only on computers with the 
               DSP-56001 signal processor.

 Group:        DSP programming

 See also:     Binding   Dsp_Lock   Dsp_Unlock   Dsp_Available 
               Dsp_Reserve   Dsp_ExecProg   Dsp_ExecBoot 
               Dsp_LodToBinary