Simple Sound for Small Devices
libsssd
last updated: 03 JUN 2003 (v0.6)

Function Name:  sssd_getLastError

    Returns the last error returned from a sssd function.

C Prototype:

int sssd_getLastError (struct sssdaudio *ga );

  Other Prototypes:



Arguments:


struct gameaudio *ga

    Pointer to an initialized sssdaudio structure (returned by sssd_initAudio)


Returns:


For more specific error information, see specific function documentation.

0 (ERR_NOERROR)
   No error

ERR_NOT_INITIALIZED
    The sssd subsystem is not initialized

ERR_DEVICE_OPEN
    Could not open the specificed audio device

ERR_CTRL_ALLOC
    Could not allocate memory for sssd control structure

ERR_PLAYBUFFER_ALLOC
    Could not allocate memory for playback/mixing buffer(s)

ERR_HARDWARE_PARMS
    An unknow hardware parameter was passed to ctrlDevice()

ERR_SYSINFO
    An error was encountered getting requested system or hardware information

ERR_THREAD_INIT
    The player/mixer thread was unable to initialize

ERR_THREAD_START
    The player/mixer thread was unable to start

ERR_THREAD_STOP
    An error was encountered trying to stop the player/mixer thread.

ERR_SAMPLES_FULL
    A new sample was attempted to be registered with SSSD, but the sample list was full

ERR_SAMPLES_ALLOC
   A new sample was attempted to be registered using loadSample or copySample, but sssd could not allocate memory to hold the sample data.

ERR_SAMPLES_FILE
    LoadSample...() could not open or read the specificed sample file.

ERR_SAMPLES_ATTRIB
    A parameter passed to ctrlSample was not recognized

ERR_SAMPLES_RANGE
   The sample parameter pass was out of range

ERR_BKG_START
   The background music decoder could not be started

ERR_BKG_FORMAT
    The format specified for the background music file isn't recognized, or 'BKG_FORMAT_BESTGUESS' couldn't figure out the type.

ERR_VOICES_ALLOC
   An error occured allocating memory to hold the voice parameters.

ERR_VOICES_FULL
    A playSample request was made, but all voices are full.

ERR_PLAYING_ID
   The playing ID passed was invalid.

ERR_PLAYING_LOOP
    An action was requested to happen on a specific sample, but it could not take place because the sample is playing in an endless loop. (for example:  blockUntilComplete())

ERR_DEVICE_UNSUPPORTED
    The playback device requested with startAudio is not supported.

ERR_DEVICE_UNKNOWN
    The playback device requested with startAudio is unknown.

ERR_DEVICE_SUSPEND
    An error occured trying to suspend sssd.

ERR_DEVICE_RESUME
    An error occured tryint to resume a suspended sssd session.



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.