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_BlkWords()
Dsp_BlkBytes()                                                        XBIOS

Syntax

VOID Dsp_BlkBytes( data_in, size_in, data_out, size_out )
UBYTE *data_in;
LONG size_in;
UBYTE *data_out;
LONG size_out;

Function      Dsp_BlkBytes() transfers a block of unsigned character data
              to the DSP and returns the output from the running program
              or subroutine.

Opcode        124 (0x7C)

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

Parameters    data_in is a pointer to an unsigned character array which is
              transferred to the DSP. size_in is the length (in bytes) of
              data to transfer. data_out is a pointer to the unsigned
              character array to be filled in from the low byte of the
              DSP's transfer register. size_out is the length (in bytes)
              of the output buffer array.

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

Caveats       No handshaking is performed with this call. Error sensitive
              data should be transferred with Dsp_BlkHandShake().

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

See Also      Dsp_BlkWords()