目次 - SDL 3.0 API(機能別) - 再生と録音 - SDL_GetAudioPlaybackDevices

SDL_GetAudioPlaybackDevices

現在接続されているオーディオ再生デバイスの一覧を得る

ヘッダ

SDL3/SDL_audio.h

構文

SDL_AudioDeviceID * SDL_GetAudioPlaybackDevices(int *count);

引数

int *count戻されたデバイスの数の代入先へのポインタ. NULLも可

戻り値

(SDL_AudioDeviceID *) 0が終端のデバイスインスタンスIDの配列を戻す. エラーのときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる. 不要になったときSDL_free()で解放する必要がある.

詳細

この関数は, スピーカーやヘッドホン(再生デバイス)のような利用可能な音声を出力するデバイスの一覧を戻す. マイク(録音デバイス)のような録音するデバイスが必要な場合は, 代わりにSDL_GetAudioRecordingDevices()を使用すること.

この関数は物理デバイスの一覧のみを戻す. SDL_OpenAudioDevice()が戻したデバイスIDは含まれない.

この関数がNULLを戻したときはエラーを表し, *codeには0が設定される.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetAudioPlaybackDevices - SDL Wiki