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.5  Dsp_BlkWords                                               TOS

 Name:         »Dsp_BlkWords« - Wordwise data transfer of an array of 
               WORDS to the DSP.

 Opcode:       123

 Syntax:       void Dsp_BlkWords( void *data_in, int32_t size_in, void 
               *data_out, int32_T size_out );

 Description:  The function copies size_in signed 16-bit words from 
               the buffer data_in to the DSP. The words are extended 
               to signed DSP-wordlength before transfer. After all 
               data has been transferred, the procedure waits until 
               the data has been processed. Then size_out 16-bit 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_BlkHandShake   Dsp_BlkBytes   Dsp_InStream 
               Dsp_OutStream   Dsp_IOStream   Dsp_GetWordSize 
               Dsp_MultBlocks