最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

audiodevinfo

オーディオ デバイスに関する情報

説明

info = audiodevinfo は、システム上の入力および出力オーディオ デバイスに関する情報を返します。

nDevices = audiodevinfo(IO) は、IO1 の場合にシステム上の入力デバイスの数を返し、IO0 の場合にシステム上の出力デバイスの数を返します。

name = audiodevinfo(IO,ID) は、デバイス識別子 ID で指定されたオーディオ デバイスの名前を返します。

DriverVersion = audiodevinfo(IO,ID,'DriverVersion') は、ID で指定されたオーディオ デバイスのドライバーの名前を返します。

support = audiodevinfo(IO,ID,Fs,nBits,nChannels) は、ID で指定された入力または出力オーディオ デバイスが、FsnBitsnChannels の値でそれぞれ指定されたサンプル レート、ビット数、チャネル数をサポートする場合に 1 を返します。それ以外の場合、support0 です。

ID = audiodevinfo(IO,name) は、デバイス名 name で識別される入力または出力オーディオ デバイスのデバイス識別子を返します。指定された名前のデバイスが見つからない場合、audiodevinfo はエラーを返します。

ID = audiodevinfo(IO,Fs,nBits,nChannels) は、FsnBitsnChannels の値でそれぞれ指定されたサンプル レート、ビット数、チャネル数をサポートする最初の入力または出力デバイスのデバイス識別子を返します。サポートするデバイスが見つからない場合は、ID-1 になります。

すべて折りたたむ

入力を指定せずに audiodevinfo を呼び出して、システム上の入力および出力オーディオ デバイスに関する情報を表示します。audiodevinfo は、inputoutput の 2 つのフィールドを含む構造体を返します。

info = audiodevinfo
info = 

  struct with fields:

     input: [1×2 struct]
    output: [1×4 struct]

入力フィールドには、オーディオ デバイス名、使用されるドライバー、およびデバイス識別子が含まれます。

info.input
ans = 

  1×2 struct array with fields:

    Name
    DriverVersion
    ID

1 番目の入力デバイスに関する情報を表示します。

info.input(1)
ans = 

  struct with fields:

             Name: 'Primary Sound Capture Driver  Windows DirectSound '
    DriverVersion: 'Windows DirectSound'
               ID: 0

2 番目の入力デバイスに関する情報を表示します。

info.input(2)
ans = 

  struct with fields:

             Name: 'HP 4120 Microphone  HP 4120   Windows DirectSound '
    DriverVersion: 'Windows DirectSound'
               ID: 1

お使いのシステムの値は、この例とは異なることがあります。

出力を示す IO の値 0 を使用して、システム上の出力オーディオ デバイスの数を表示します。

nDevices = audiodevinfo(0)
nDevices =

     4

この例では 3 つの出力デバイスを示していますが、お使いのシステムとは異なる場合があります。

ID0 で識別される入力オーディオ デバイスが、サンプル レート 44100 Hz、サンプルあたりのビット数 16、2 チャネルをサポートしているかどうかをチェックします。

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

  logical

   1

この入力デバイスは、指定されたサンプル レート、ビット数およびチャネル数をサポートします。使用するシステムに応じて結果は異なる場合があることに注意してください。

入力引数

すべて折りたたむ

入力または出力デバイス。入力を示す場合は 1、出力を示す場合は 0 として指定する。

整数として指定する、オーディオ デバイス識別子。デバイスは、入力または出力オーディオ デバイスです。

正のスカラーとして指定するサンプル レート (Hz)。

例: 44100

データ型: single | double

スカラーとして指定する、サンプルごとのビット数。

例: 16

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

1 (モノラル) または 2 (ステレオ) として指定するオーディオ チャネルの数。

入力または出力オーディオ デバイスの名前。文字ベクトルとして指定します。

データ型: char

出力引数

すべて折りたたむ

inputoutput の 2 つのフィールドを含む構造体配列として返される、オーディオ デバイスに関する情報。各フィールドは、構造体からなる配列であり、それぞれの構造体はシステム上のオーディオ入力または出力デバイスのいずれかに関する情報を含みます。個々のデバイス構造体フィールドは、次のとおりです。

  • Name — 文字ベクトルとして返される、デバイスの名前。

  • DriverVersion — 文字ベクトルとして返される、デバイスとの通信に使用されるドライバーの名前。

  • ID — スカラーとして返される、デバイス識別子。

R2006a より前に導入