Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

audiodevinfo

Information about audio device

Syntax

  • info = audiodevinfo
    example
  • nDevices = audiodevinfo(IO)
    example
  • name = audiodevinfo(IO,ID)
  • DriverVersion = audiodevinfo(IO,ID,'DriverVersion')
  • support = audiodevinfo(IO,ID,Fs,nBits,nChannels)
    example
  • ID = audiodevinfo(IO,name)
  • ID = audiodevinfo(IO,Fs,nBits,nChannels)

Description

example

info = audiodevinfo returns information about the input and output audio devices on the system.

example

nDevices = audiodevinfo(IO) returns the number of input devices on the system if IO is 1, and returns the number of output devices on the system if IO is 0.

name = audiodevinfo(IO,ID) returns the name of the audio device specified by the device identifier, ID.

DriverVersion = audiodevinfo(IO,ID,'DriverVersion') returns the name of the driver for the audio device specified by ID.

example

support = audiodevinfo(IO,ID,Fs,nBits,nChannels) returns 1 if the input or output audio device specified by ID supports the sample rate, number of bits, and number of channels specified by the values of Fs, nBits, and nChannels, respectively. Otherwise, support is 0.

ID = audiodevinfo(IO,name) returns the device identifier of the input or output audio device identified by the device name, name. If no device is found with the specified name, then audiodevinfo returns an error.

ID = audiodevinfo(IO,Fs,nBits,nChannels) returns the device identifier of the first input or output device that supports the sample rate, number of bits, and the number of channels specified by the values of Fs, nBits, and nChannels, respectively. If no supporting device is found, then ID is -1.

Examples

collapse all

Call audiodevinfo with no inputs to view information about the input and output audio devices on a system.

info = audiodevinfo
info = 

     input: [1x2 struct]
    output: [1x3 struct]

audiodevinfo returns a structure containing two fields, input and output.

View the contents of the input field in the Variables editor.

openvar info.input

The Variables editor displays the input audio device names, driver used, and device identifiers. The values on your system might differ from this example.

View the number of output audio devices on the system, using an IO value of 0 to indicate output.

nDevices = audiodevinfo(0)
nDevices =

     3

This example shows three output devices, but your system might vary.

Check if the input audio device identified by the ID value, 0, supports a sample rate of 44100 hertz, with 16 bits per sample, and two channels.

support = audiodevinfo(1,0,44100,16,2)
support =

     1

The input device supports the specified sample rate, number of bits and number of channels.

Input Arguments

collapse all

Input or output device, specified as 1 to indicate input, or 0 to indicate output.

Audio device identifier, specified as an integer. The device can be an input or output audio device.

Sample rate, in hertz, specified as a positive scalar.

Example: 44100

Data Types: single | double

Number of bits per sample, specified as a scalar.

Example: 16

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Number of audio channels, specified as 1 (mono) or 2 (stereo).

Name of the input or output audio device, specified as a character vector.

Data Types: char

Output Arguments

collapse all

Information about audio devices, returned as a structure array containing two fields, input and output. Each field is an array of structures, with each structure containing information about one of the audio input or output devices on the system. The individual device structure fields are:

  • Name — Name of the device, returned as a character vector.

  • DriverVersion — Name of the driver used to communicate with the device, returned as a character vector.

  • ID — Device identifier, returned as a scalar.

Introduced before R2006a

Was this topic helpful?