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