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

# SDL_GetQueuedAudioSize

キューにある音声データのバイト数を得る

## 構文

`void SDL_GetQueuedAudioSize(SDL_AudioDeviceID dev)`

## 引数

dev | 音声のサイズを得るデバイスのID

## 戻り値

キューの音声データのバイト数(サンプル数ではない!)を戻す.

## 詳細

再生デバイスに対しては, SDL_QueueAudio()で再生のためにキューに入れられ, まだハードウェアに送られていないデータのバイト数である.

ハードウェアに送られた後は, この関数は何バイト再生されたかはわからない. この関数を呼ぶ前に, ハードウェアに数キロバイトの音声データを単に送ることは可能である. しかしその場合は, 全く再生されていないのか, それとも半分再生されたのかなどはわからない.

録音デバイスに対しては, デバイスが取り込んだが, キューから取り出されるのを待っているデータのバイト数である. この値は増加し続ける. この値は単に利用可能なデータの下限である.

アプリケーション提供のコールバック関数が使うデバイスに音声をキューに出し入れしてはならない. そのようなデバイスに対しては, この関数は常に0を戻す. コールバック関数を使うか, キューを使うかのは, どちらか一方で両方を行ってはならない.

キューを消去する前にSDL_LockAudio()を呼んではならない. この関数の内部でSDLはロックを扱っている.

## バージョン

SDL 2.0.4以降

## 関連項目(関数)

SDL_ClearQueuedAudio
SDL_QueueAudio
SDL_DequeueAudio

## SDL Wikiへのリンク

SDL_GetQueuedAudioSize - SDL Wiki