---
name: "AuSoundPlayFromFile"
section: "3nas"
platform: "linux"
package: "libaudio-dev"
version: "1.9.4-9"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/AuSoundPlayFromFile"
---

# AuSoundPlayFromFile(3nas)

create a flow to play a file.

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