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

Function Name:  sssd_getAudioInfo

   Return information about the currently running sssd audio subsystem.

C Prototype:

int sssd_getAudioInfo (struct sssdaudio *ga, int *infoArray, int numItems);

  Other Prototypes:



Arguments:


struct gameaudio *ga

    Pointer to an initialized sssdaudio structure (returned by sssd_initAudio)

int *infoArray

    This needs to be a pointer to an int array AI_NUMINFOITEMS in size.  The following defines can be used to access the information in the array:

AI_CHANNELS
AI_FREQ
AI_BITS
AI_MAXVOICES
AI_PLAYINGVOICES
AI_MAXSAMPLES
AI_SAMPLES
AI_PAUSED
AI_BGSTREAM
AI_BUFFERSIZE

int numItems

    This is the number if items to fetch.  It is for future backwards compatibility and should always be set to AI_NUMINFOITEMS.

Returns:


Number of items filled in array.  If <AI_NUMINFOITEMS, then the running sssd subsystem could be an older version than the program was compiled against.

Example:

/* array to hold the data */
int audioinfo[AI_NUMINFOITEMS];

/* get the info */
ret=getAudioInfo( ga, audioinfo, AI_NUMINFOITEMS );

if(ret<AI_NUMINFOITEMS)
   puts("Application knows about more parameter than installed libsssd does");

printf("Currently running libsssd thread info:\n");
printf("\tchannels=%d\n\tfrequency=%d\n",audioinfo[AI_CHANNELS],audioinfo[AI_FREQ]);



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.