•  Back 
  •  XBIOS Function Reference 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  %About 
  •  Show info about hypertext 
  •  View a new file 
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-FileSndstatus()                                                           XBIOS

Syntax

LONG Sndstatus( reset )
WORD reset;

Function      Sndstatus() can be used to test the error condition of the
              sound system and to completely reset it.

Opcode        140 (0x8C)

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

Parameters    reset is a flag indicating whether the sound system should be
              reset. A value of SND_RESET (1) will reset the sound system.

Binding       move.w   reset,-(sp)
              move.w   #$8C,-(sp)
              trap     #14
              addq.l   #4,sp

Return Value  Sndstatus() returns a LONG bit array indicating the current
              error status of the sound system defined as follows:

              Bit(s)  Meaning

               0-3   These bits form a value indicating the error
                     condition of the sound system as follows:

                     Name           Mask   Meaning
                     SND_ERROR       0xF   Use to mask error code

                     Name           Value  Meaning
                     SND_OK           0    No Error
                     SND_BADCONTROL   1    Invalid Control Field
                     SND_BADSYNC      2    Invalid Sync Format
                     SND_BADCLOCK     3    Clock out of range

                4    If this bit is set, left channel clipping has
                     occurred. Use the mask SND_LEFTCLIP (0x10) to
                     isolate this bit.

                5    If this bit is set, right channel clipping has
                     occurred. Use the mask SND_RIGHTCLIP (0x20) to
                     isolate this bit.

               6-31  Unused.

Comments      On reset, the following things happen:

DSP is tristated
                     ∙ Gain and attentuation are zeroed
                     ∙ Old matrix connections are reset
ADDERIN is disabled
                     ∙ Mode is set to 8-Bit Stereo
                     ∙ Play and record tracks are set to 0
                     ∙ Monitor track is set to 0
                     ∙ Interrupts are disabled
                     ∙ Buffer operation is disabled