Name

       AuSoundPlay - create a flow to play audio from any source.

Synopsis

       #include <audio/audiolib.h>
       #include <audio/soundlib.h>

       AuEventHandlerRec  *AuSoundPlay(server,  destination,  volume,  mode, sound_data, flow ,volume_mult_elem,
       monitor_element, status)
           AuServer *server;
           AuDeviceID destination;
           AuFixedPoint volume;
           int mode;
           AuSoundDataPtr sound_data;
           AuFlowID *flow; /* RETURN */
           int *volume_mult_elem; /* RETURN */
           int *monitor_element; /* RETURN */
           AuStatus *status; /* RETURN */

Arguments

       server    Specifies the connection to the audio server.

       destination
                 Specifies the device to output the audio data.

       volume    Specifies the volume.

       mode      Specifies the line mode for the output device.  Currently the following line modes are defined:
                 AuDeviceOutputModeNone,         AuDeviceOutputModeSpeaker,         AuDeviceOutputModeHeadphone,
                 AuDeviceOutputModeLineOut.

       sound_data
                 Specifies the sound information.

       flow      If non-NULL, returns the flow ID.

       volume_mult_elem
                 If non-NULL, returns the index of the volume multipler element.

       monitor_element
                 If non-NULL, include an ExportMonitor element in the flow and return it's index.

       status    If non-NULL, flush the output buffer and return the status from the server.

Description

       AuSoundPlay creates a flow to play audio from any source on device and returns a  pointer  to  the  event
       handler  created  or  NULL  if  there  was  an  error.  The  sound_data  structure contains the necessary
       information about the audio format and the data handling function.

Errors

       AuBadDevice.

See Also

       AuSoundPlayFromBucket, AuSoundPlayFromData, AuSoundPlayFromFile, AuSoundPlaySynchronousFromFile.

       audiolib - Network Audio System C Language Interface