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

SDL_PutAudioStreamData

ストリームにデータを追加する

ヘッダ

SDL3/SDL_audio.h

構文

bool SDL_PutAudioStreamData(SDL_AudioStream *stream, const void *buf, int len);

引数

SDL_AudioStream *streamオーディオデータを追加するストリーム
const void *buf追加するオーディオデータへのポインタ
intlenストリームに書き込むデータのバイト数

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す SDL_GetError()を呼んで詳細を知ることができる.

詳細

データは, 形式/チャネル/周波数が, 最後に呼んだSDL_SetAudioStreamFormat, または変更していないならばストリームを生成したときのものと一致している必要がある.

この関数の呼び出しでは, 後の処理のために未変換のデータを単にコピーするだけなので注意すること. これは, 追加の関数の呼び出しでデータの変換を行い, 獲得側では変換されたデータを単にキューから取り出していたSDL2とは異なる.

スレッドセーフ

この関数はどのスレッドからも安全に呼べるが, ストリームにコールバックが設定されている場合は, 呼び出し側のロックが必要になる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_PutAudioStreamData - SDL Wiki