Main Content


(Not recommended) Add audio output channel to session

This session object function is not recommended. Use DataAcquisition object functions instead. See Compatibility Considerations.



ch = addAudioOutputChannel(s,deviceName,channelID) creates and displays the object ch representing a channel added to the session s using the device represented by deviceName, with the specified channelID. The channel is stored in the variable ch.



[ch,idx] = addAudioOutputChannel(s,deviceName,channelID) additionally assigns idx with the index into the array of the session object's Channels property.


collapse all

Create a session and add an audio output channel to it.

s = daq.createSession ('directsound');
ch = addAudioOutputChannel(s,'Audio1',1);

Add several audio output channels to a session, and assign the index array.

Add two audio output channels to a session and assign output arguments to represent the channel objects and their indices.

s = daq.createSession ('directsound');
[ch,idx] = addAudioOutputChannel(s,'Audio3',1:2);

Input Arguments

collapse all

Data acquisition session specified as a session object created using daq.createSession. Use the data acquisition session for acquisition and generation operations. Create one session per vendor and use that vendor session to perform all data acquisition operations.

Device ID as defined by the device vendor, specified as a character vector or string. Obtain the device ID by calling daq.getDevices. The channel specified for this device is created for the session object.

Data Types: char | string

Channel ID, or the physical location of the channel on the device, added to the session, specified as a numeric value. Supported values are specific to the vendor and device. You can also add a range of channels. The index for this channel displayed in the session indicates this channel's position in the session. If you add a channel with channel ID 1 as the first channel in a session, the session index is 1.

Output Arguments

collapse all

Audio output channel that you add, returned as a channel object containing vendor specific channel information. Use this channel object to access device and channel properties. The channel object has the following properties.

BitsPerSampleDisplay bits per sample
DeviceChannel device information
IDID of channel in session
MeasurementTypeChannel measurement type
NameSpecify descriptive name for the channel
RangeSpecify channel measurement range
StandardSampleRatesDisplay standard rates of sampling
UseStandardSampleRatesConfigure session to use standard sample rates

Channel index returned as a numeric value. Through the index you can access the array of the session object's Channels property.

Version History

Introduced in R2014a

expand all