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_BlkHandShake()
Dsp_DoBlock()
Dsp_InStream()                                                        XBIOS

Syntax

VOID Dsp_InStream( data_in, block_size, num_blocks, blocks_done )
char *data_in;
LONG block_size;
LONG num_blocks;
LONG *blocks_done;

Function      Dsp_InStream() passes data to the DSP via an interrupt
              handler.

Opcode        99 (0x63)

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

Parameters    data_in is a pointer to unsigned character data which should
              be transferred to the DSP. block_size indicates the number
              of DSP WORDs that will be transferred at each interrupt.
              num_blocks indicates the number of blocks to transfer. The
              LONG pointed to by blocks_done will be constantly updated to
              let the application know the progress of the transfer.

Binding       pea      blocks_done
              move.l   num_blocks,-(sp)
              move.l   block_size,-(sp)
              pea      data_in
              move.w   #$63,-(sp)
              trap     #14
              lea      18(sp),sp

Caveats       No handshaking is performed with this call. If the data you
              are transmitting is error sensitive, use Dsp_BlkHandShake().

Comments      This call is suited for transferring small blocks while
              other blocks are being prepared for transfer. For larger
              blocks, Dsp_DoBlock() would be more suitable.

See Also      Dsp_BlkHandShake(), Dsp_DoBlock()