AuSoundPlayFromFile: None

\fBName\fP

AuSoundPlayFromFile - create a flow to play a file.

\fBSynopsis\fP

#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 */

\fBArguments\fP

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.

\fBDescription\fP

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.

\fBErrors\fP

AuBadDevice.

\fBSee Also\fP

AuSoundPlay, AuSoundPlayFromBucket, AuSoundPlayFromData, AuSoundPlaySynchronousFromFile.

audiolib - Network Audio System C Language Interface