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.18  Dsp_InStream                                              TOS

 Name:         »Dsp_InStream« - Data transfer to the DSP via an 
               interrupt handler

 Opcode:       99

 Syntax:       void Dsp_InStream( int8_t *data_in, int32_t block_size, 
               int32_t num_blocks, int32_t *blocks_done );

 Description:  The function copies via a DSP interrupt handler 
               num_blocks data blocks with a size of block_size DSP- 
               words from the buffer data_in to the DSP. For each 
               interrupt one block will be transferred, irrespective 
               of whether the DSP is ready to receive or not. At the 
               same time the counter blocks_done, which keeps track of 
               the number of blocks transferred, will be incremented. 
               As the data is transferred via an interrupt, the 
               procedure does not have to wait. Via blocks_done the 
               program can then determine whether the transfer has 
               been completed.

 Return value: The function does not return a result.

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

 Group:        DSP programming

 See also:     Binding   Dsp_DoBlock   Dsp_BlkUnpacked 
               Dsp_BlkHandShake   Dsp_BlkWords   Dsp_BlkBytes 
               Dsp_OutStream   Dsp_IOStream   Dsp_GetWordSize 
               Dsp_SetVectors   Dsp_RemoveInterrupts   Dsp_MultBlocks