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

SDL_PauseAudioStreamDevice

オーディオデバイスに関連付けられたオーディオストリームの再生を一時停止する

ヘッダ

SDL3/SDL_audio.h

構文

bool SDL_PauseAudioStreamDevice(SDL_AudioStream *stream);

引数

SDL_AudioStream *stream一時停止させるオーディオデバイスに関連付けられたオーディオストリーム

戻り値

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

詳細

指定したデバイスのオーディオ処理を一時停止する. バインドされた全てのオーディオストリームの処理は行われず, 音声も生成されない. あるデバイスを一時停止しても, 他の一時停止されていないデバイスには影響しない.

デバイスを一時停止させることは, オーディオデバイスのバインドを解除させずに音声を停止させたいときに使える. これはゲームをポーズさせるときや, ステージを読み込むときなどに便利である.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_PauseAudioStreamDevice - SDL Wiki