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_Unlock()
Dsp_Lock()                                                            XBIOS

Syntax

WORD Dsp_Lock( VOID )

Function      Dsp_Lock() locks the use of the DSP to the calling
              application.

Opcode        104 (0x68)

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

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

Return Value  Dsp_Lock() returns a 0 if successful or -1 if the DSP has
              been locked by another application.

Comments      Dsp_Lock() should be performed before each use of the DSP to
              prevent other applications from modifying DSP memory or
              flushing subroutines. A corresponding Dsp_Unlock() should
              be issued at the end of each usage. You should limit the
              amount of time the DSP is locked so other applications may
              utilize it.


See Also      Dsp_Unlock()