Reads data from a sound input device. You must use the Sound Input Configure VI to configure the device. 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.


icon

Inputs/Outputs

  • ci32.png number of samples/ch

    number of samples/ch specifies the number of samples per channel to read from the buffer.

  • 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 Input Configure VI.

  • 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 VI 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.

  • iu32.png task ID out

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

  • i1dmsdt.png data

    data reads any sound data from 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.

  • 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\Continuous Sound Input.vi
    • labview\examples\Graphics and Sound\Sound\Finite Sound Input.vi
    • labview\examples\Graphics and Sound\Sound\Simultaneous Sound Input Output.vi