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.25  Dsp_OutStream                                             TOS

 Name:         »Dsp_OutStream« - Data transfer from DSP via an 
               interrupt handler to a given buffer

 Opcode:       100

 Syntax:       void Dsp_OutStream( int8_t *data_out, 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 DSP into the buffer data_out. For each 
               interrupt one block will be transferred. At the same 
               time the counter blocks_done, which keeps track of the 
               number of blocks transferred, will be incremen- ted. As 
               the data is transferred via an interrupt, the function 
               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_InStream   Dsp_IOStream   Dsp_GetWordSize 
               Dsp_SetVectors   Dsp_RemoveInterrupts   Dsp_MultBlocks