DragonFly On-Line Manual Pages

AuSoundPlayFromFile(3)                      DragonFly Library Functions Manual

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

soundlib                             1.9.4              AuSoundPlayFromFile(3)