\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