Simple Sound for Small Devices
libsssd
last updated: 26 JUN 2003 (v0.81)

Function Name:  sssd_startAudio

   Start sssd audio system: open device (usually /dev/dsp), setup device parameters, initialize tables, start thread.


C Prototype:

int sssd_startAudio (struct sssdaudio *ga, const char *device_name);

  Other Prototypes:



Arguments:


struct gameaudio *ga

    Pointer to an initialized sssdaudio structure (returned by sssd_initAudio)

const char *device_name

    Device name to use for audio, or DEFAULT_DEVICE as defined in sssd.h  Ignored under Windows and Windows CE.  The following additional names are defined for Linux and linux-hosted AmigaDE.

ESD_DEVICE_NAME
EsounD sound server (OSS is default)



Returns:


0
    Success

ERR_DEVICE_OPEN
    Could not open audio device. (most likely playback hardware is busy.)

ERR_HARDWARE_BITS
    Requested bit-depth (8 or 16) is not supported by the hardware

ERR_HARDWARE_CHAN
    Requested number of channels is not supported by the hardware

ERR_HARDWARE_FREQ
    Requested sample frequency is not supported by the hardware

ERR_HARDWARE_FRAG
    Requested audio buffer size caused an error with the hardware

ERR_MUTEX_INIT
    Could not create communication mutex for mixer thread.

ERR_THREAD_START
    Could not start mixer thread



libsssd (c)2003 Patrick Roberts created from libgaudio (c) 1999-2000 A. Schiffler.  Release as open source under MPL 1.1.  Documentation (c)2003 Patrick Roberts.