AuSoundPlayFromFile.3x man page

Name

AuSoundPlayFromFile - create a flow to play a file.

Synopsis

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

AuEventHandlerRec *AuSoundPlayFromFile(server, filename, destination, volume, callback, callback_data, flow ,volume_mult_elem, monitor_element, status)
AuServer *server;
char *filename;
AuDeviceID destination;
AuFixedPoint volume;
void (*callback) (AuServer *, AuEventHandlerRec *,AuEvent *,AuPointer);
AuPointer callback_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.
filename
Specifies the name of the file to play.
destination
Specifies the device to output the audio data.
volume
Specifies the volume.
callback
Specifies the procedure to be called for additional event processing.
callback_data
Specifies any additional arguments to be passed to the callback.
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

AuSoundPlayFromFile creates a flow to play filename on device and returns a pointer to the event handler created or NULL if there was an error.

Errors

AuBadDevice.

See Also

AuSoundPlay, AuSoundPlayFromBucket, AuSoundPlayFromData, AuSoundPlaySynchronousFromFile.

audiolib - Network Audio System C Language Interface

Info

1.9.4 soundlib