Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileDsp_BlkBytes()
Dsp_BlkWords()                                                        XBIOS

Syntax

VOID Dsp_BlkWords( data_in, size_in, data_out, size_out )
WORD *data_in;
LONG size_in;
WORD *data_out;
LONG size_out;

Function      Dsp_BlkWords() transfers an array of WORDs to the DSP and
              returns the output generated by the running subroutine or
              program.

Opcode        123 (0x7B)

Availability  Available only when bit #3 of the '_SND' cookie is set.

Parameters    data_in is a pointer to the WORD array to be transferred to
              the DSP. size_in is the length (in WORDs) of data to
              transfer. data_out is a pointer to the WORD array to be
              filled in during the data output phase of the DSP from the
              middle and low bytes of the transfer register. size_out is
              the length (in WORDs) of the buffer for the output array.

Binding       move.l   size_out,-(sp)
              pea      data_out
              move.l   size_in,-(sp)
              pea      data_in
              move.w   #$7B,-(sp)
              trap     #14
              lea      18(sp),sp

Caveats       No handshaking is performed with this call. Data which is
              sensitive to errors should use Dsp_BlkHandShake().

Comments      WORDs are sign extended before transfer. Also, due to the
              length of static memory in the DSP, size_in and size_out
              should not exceed 32768.

See Also      Dsp_BlkBytes()