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.3  Dsp_BlkHandShake                                           TOS

 Name:         »DspBlkHandShake« - Data transfer to DSP with 
               handshake.

 Opcode:       97

 Syntax:       void Dsp_BlkHandShake( int8_t *data_in, int32_t 
               size_in, int8_t *data_out, int32_t size_out );

 Description:  The function copies size_in DSP-words from the buffer 
               data_in to the DSP. After all data has been 
               transferred, the procedure waits until the data has 
               been processed. Then size_out DSP-words are copied back 
               into the buffer data_out, irrespective of how much data 
               is actually present. If no data is to be sent, one has 
               to set size_in to zero. The same applies for the 
               receipt; in that case size_out is assigned zero. 
               size_in and size_out are limited to 64 kbyte. Data is 
               only exchanged when the DSP process is ready for this.

 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_BlkWords 
                 Dsp_BlkBytes   Dsp_InStream   Dsp_OutStream 
               Dsp_IOStream   Dsp_GetWordSize   Dsp_MultBlocks