目次 - API(機能別) - 再生と録音 - SDL_GetAudioDeviceSpec

SDL_GetAudioDeviceSpec

指定の音声デバイスの推奨オーディオ形式を得る

構文

int SDL_GetAudioDeviceSpec(int index, int iscapture, SDL_AudioSpec* spec)

引数

index音声デバイスの番号. 有効な範囲は0からSDL_GetNumAudioDevices()-1
iscapture0以外のとき録音デバイス, 0のとき再生デバイスを得る
specこの関数によって書き込まれるSDL_AudioSpec

戻り値

成功のとき0, 失敗のとき0以外を戻す.

詳細

この関数は, オーディオサブシステムが正常に初期化されている場合のみ使用できる. この関数が戻す値の個数は, 最後にSDL_GetNumAudioDevices()を呼んだ時点のものである. 再び呼ぶと, 利用できるハードウェアを再検索する.

specには周波数, データ形式, チャネル数が書き込まれる. 他の構造体メンバーは全て0となる. SDLバックエンドが値を得られなかった場合, 値は0になる.

バージョン

2.0.16以降

関連項目(関数)

SDL_GetDefaultAudioInfo
SDL_GetNumAudioDevices

SDL Wikiへのリンク

SDL_GetAudioDeviceSpec - SDL Wiki