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
Referenced By
AuSoundPlay.3x(3), AuSoundPlayFromBucket.3x(3), AuSoundPlayFromData.3x(3), AuSoundPlaySynchronousFromFile.3x(3).