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_RunSubroutine()
Dsp_InqSubrAbility()
Dsp_LoadSubroutine()                                                  XBIOS

Syntax

WORD Dsp_LoadSubroutine( ptr, size, ability )
char *ptr;
LONG size;
WORD ability;

Function      Dsp_LoadSubroutine() transmits subroutine code to the DSP.

Opcode        116 (0x74)

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

Parameters    ptr points to a memory buffer which contains DSP binary
              subroutine code. size is the length of code to transfer
              (specified in DSP words). ability is the WORD identifier for
              the unique ability of this subroutine.

Binding       move.w   ability,-(sp)
              move.l   size,-(sp)
              pea      ptr
              move.w   #$74,-(sp)
              trap     #14
              lea      12(sp),sp

Return Value  Dsp_LoadSubroutine() returns the handle assigned to the
              subroutine or 0 if an error occurred.

Comments      DSP subroutines have many restrictions and you should see
              the previous discussion of the DSP for more information.

See Also      Dsp_RunSubroutine(), Dsp_InqSubrAbility()