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.4  Dsp_BlkUnpacked                                            TOS

 Name:         »Dsp_BlkUnpacked« - Data transfer of DSP-words with a 
               maximum length of 4 bytes (longword array).

 Opcode:       98

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

 Description:  This function only works with DSP-words having a 
               maximum length of 4 bytes. The length of the DSP-words 
               can be found with Dsp_GetWordSize. Both data_in and 
               data_out are LONG fields. size_in and size_out refer to 
               the size of the fields in longwords. Depending on the 
               length of the DSP-word, only the lower bytes are 
               transferred to the LONGs. 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.
               There is no guarantee that the higher-valued bytes of 
               the received LONGs are zero when the DSP-wordlength is 
               less than 4.

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