AuSoundPlayFromFile

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.