Writes data to a sound output device. You must use the Sound Output Configure VI to configure the device if you are writing continuously. You must manually select the polymorphic instance you want to use.

(Windows) You must have DirectX 8.0 or later to use this VI. (Linux) You must have the Open Sound System (OSS) driver to use this VI.

Note If the buffer you set using the number of samples/ch input of the Sound File Read VI is full when the application executes, LabVIEW automatically implements a wait on the Sound Output Write VI even if you set timeout to 0. This may cause the data flow to hang and return unexpected results.


icon

Inputs/Outputs

  • cu32.png task ID —

    task ID is the sound operation from the configured device you want to manipulate or input.

    You generate task ID with the Sound Output Configure VI.

  • c1dwdtint.png data —

    data writes any sound data to the internal buffers. For multi-channel sound data, data is an array of waveforms where each element of the array is a single channel.

    The specified data type determines the range of values for the sound data.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • cdbl.png timeout (sec) —

    timeout (sec) specifies the time, in seconds, that the function waits for the sound operation to complete.

    This VI returns an error if the time elapses. The default is 10. If you set timeout (sec) to -1, the VI waits indefinitely. If you set timeout (sec) to 0, the VI returns immediately while the sound continues to play. You can use the Sound Output Wait VI to wait for playback to complete.

  • iu32.png task ID out —

    task ID out is the manipulated sound operation originally passed to the task ID parameter.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\Graphics and Sound\Sound\Sound File to Sound Output.vi
    • labview\examples\Graphics and Sound\Sound\Generate Sound.vi
    • labview\examples\Graphics and Sound\Sound\Simultaneous Sound Input Output.vi