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

SDL_GetAudioStreamAvailable

オーディオストリームの利用可能な変換/再サンプリングされたバイト数を得る

ヘッダ

SDL3/SDL_audio.h

構文

int SDL_GetAudioStreamAvailable(SDL_AudioStream *stream);

引数

SDL_AudioStream *stream問い合わせるオーディオストリーム

戻り値

(int) 利用可能な変換/再サンプリングされたバイト数を戻す. 失敗のとき-1を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

ストリームは, 正しく再サンプリングするのに十分な量になるまで内部にデータをバッファしているため, この値は予想よりも小さく, 0の場合もありうる. データが十分になったとき, ストリームへの新しいデータの追加や掃き出しが行われる.

ストリームのデータが多すぎてintをオーバーフローしそうになると, 最大値で制限され, データはキューに入らず失われる. ギガバイト単位のデータがキューにある場合は, アプリケーションはこの関数の戻り値が制限される前にSDL_GetAudioStreamDataで読み込む必要がある.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetAudioStreamAvailable - SDL Wiki