Table Of Contents

Sound Input Configure (G Dataflow)

Last Modified: June 1, 2017

Configures a sound input device to acquire data and send the data to the buffer. Use Sound Input Read to read the data.

You must have DirectX 8.0 or later to use this node.


number of samples/ch

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.


sample mode

Setting to acquire samples just once or continuously.

Name Value Description
Finite Samples 0

Acquire samples just once. In this mode, call this node only until you have written the number of samples specified in number of samples/ch.

Continuous Samples 1

Acquire samples continuously. In this mode, you can call this node repeatedly as needed.

Default: 1—Continuous Samples


device ID

The input or output device you access for a sound operation. The value ranges from 0 to n-1, where n is the number of input or output devices on the computer. In general, most users should select 0.

Default: 0


sound format

The acquisition 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.

Not all operating systems and sound cards support all sound format options.

Performance Details

sample rate (S/s) bits per sample

sample rate (S/s)

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.


number of channels

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.


bits per sample

Quality of each sample in bits. Common resolutions are 16 bits and 8 bits.

Default: 16 bits


error in

Error conditions that occur before this node runs. The node responds to this input according to standard error behavior.

Default: No error


task ID

An identification number associated with the configuration on the specified device. You can pass task ID to other sound operation nodes.


error out

Error information. The node produces this output according to standard error behavior.

Where This Node Can Run:

Desktop OS: Windows

FPGA: Not supported

Recently Viewed Topics