Sound Output Configure VI

Configures a sound output device to generate data. Use the Sound Output Write VI to write the data to the device.

(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 in the buffer.

    Use a large number of samples for continuous operations. Use a smaller number of samples if you want to use less memory.

  • ci32.png sample mode —

    sample mode specifies whether you intend to write just once (Finite Samples) or continuously (Continuous Samples).

    In Finite Samples mode, call Sound Output Write only until you have written the number of samples specified in number of samples/ch. In Continuous Samples mode, you can call Sound Output Write repeatedly as needed.

  • cu32.png device ID —

    device ID is the input or output device you access for a sound operation. In general, most users should select the default value of 0.

    The value ranges from 0 to n–1, where n is the number of input or output devices on the computer.

  • cnclst.png sound format —

    sound format sets the playing rate, the number of channels, and the bits per sample of the sound operation. The values for each of these controls is dependent on your sound card.

    Note Setting sample rate (S/s) and bits per sample high uses more of the computer memory when the VI runs. Also, not all operating systems and sound cards support all sound format options.
  • cdbl.png sample rate (S/s) —

    sample rate (S/s) sets the sampling rate for the sound operation. Common rates are 44,100 S/s, 22,050 S/s, and 11,025 S/s. The default is 22,050 S/s.

  • ci32.png number of channels —

    number of channels specifies the number of channels. This input can accept as many channels as the sound card supports. For most sound cards 1 is Mono and 2 is Stereo.

  • ci32.png bits per sample —

    bits per sample specifies the quality of each sample in bits. Common resolutions are 16 bits and 8 bits. The default is 16 bits.

  • cerrcodeclst.png error in (no error) —

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

  • iu32.png task ID —

    task ID returns an identification number associated with the configuration on the specified device. You can pass task ID to other sound operation VIs.

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