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_DoBlock()
Dsp_BlkHandShake()                                                    XBIOS

Syntax

VOID Dsp_BlkHandShake( data_in, size_in, data_out, size_out )
char *data_in;
LONG size_in;
char *data_out;
LONG size_out;

Function      Dsp_BlkHandShake() handshakes a block of  bytes to the DSP
              and returns the output generated by the running subroutine
              or program.

Opcode        97 (0x61)

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

Parameters    data_in is a pointer to data being sent to the DSP. size_in
              specifies the number of DSP words of data to be transferred.
              Dsp_GetWordSize() can be used to determine the number of
              bytes that occur for a DSP word. data_out is a pointer to the
              buffer to which processed data will be returned from the
              DSP. size_out indicates the number of DSP words to transfer.

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

Comments      Dsp_BlkHandShake() is identical to Dsp_DoBlock(), however,
              this function handshakes each byte to prevent errors in
              sensitive data.

See Also      Dsp_DoBlock()