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_InqSubrAbility()
Dsp_GetProgAbility()
Dsp_RequestUniqueAbility()                                            XBIOS

Syntax

WORD Dsp_RequestUniqueAbility( VOID )

Function      Dsp_RequestUniqueAbility() generates a random ability code
              that is currently not in use.

Opcode        113 (0x71)

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

Binding       move.w   #$71,-(sp)
              trap     #14
              addq.l   #2,sp

Return Value  Dsp_RequestUniqueAbility() returns a unique ability code to
              assign to a subroutine or program.

Comments      Using this function allows you to call Dsp_InqSubrAbility()
              and Dsp_GetProgAbility() to determine if the DSP code your
              application has already loaded is still present (i.e. has
              not been flushed by another application).

See Also      Dsp_InqSubrAbility(), Dsp_GetProgAbility()