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

# SDL_LockAudioDevice

指定のオーディオデバイスのコールバック関数の呼び出しをロックする

## 構文

`void SDL_LockAudioDevice(SDL_AudioDeviceID dev)`

## 引数

dev | ロックするオーディオデバイスのID

## サンプルコード

``

    void MyAudioCallback(void *userdata, Uint8* stream, int len)
    {
        printf("オーディオコールバック開始!\n");
        SDL_memset(stream, 0, len);  // ただ沈黙のみ
        printf("オーディオコールバック終了!\n");
    }

    // 実際には一度に2秒も止めないようにすること
    extern SDL_AudioDeviceID devid;
    SDL_Delay(2000);  // コールバックは2秒間動作する
    SDL_LockAudioDevice(devid);
    printf("今からオーティオコールバックは動作しない!\n");
    SDL_Delay(2000);  // コールバックは2秒間動作しない
    printf("OK, アンロックした!\n");
    SDL_UnlockAudioDevice(devid);
    SDL_Delay(2000);  // コールバックは2秒間動作する

## 詳細

これらのロック操作関数は, SDL_OpenAudioDevice()で設定したコールバック関数を停止する. SDL_LockAudioDevice()とSDL_UnlockAudioDevice()の間は, オーディオデバイスを一時停止していなくてもコールバック関数は実行されないことが保障されている. あるオーディオデバイスがロックされている間でも, 別のロックされていないオーディオデバイスは再生が一時停止されていない限り実行される.

コールバック関数の中でこの関数を呼ぶ必要はない. SDLはコールバック関数を呼ぶ前にロックしている. そして関数を抜けるとロックを解除する.

必要以上に長くロックするべきではない. ロックが長すぎると, 再生の抜けが発生する. 理想的には, ロックした後はいくつかの変数に代入するだけにして, すぐにロック解除するべきだ. オーディオデバイスをロックしている間に重い処理をしてはならない.

オーディオデバイスを複数回ロックしても, 同じ回数ロック解除すれば安全である. この場合もコールバック関数は完全にロック解除されるまで実行されない. アプリケーションがオーディオデバイスの正常なロック解除に失敗すれば, コールバック関数は呼ばれなくなる. この場合, 同じ音が繰り返し聞こえるだろう. 恐らくSDL_CloseAudioDevice()もデッドロック状態になる.

内部的には, オーディオデバイスのロックはmutexである. 2つのスレッドで同時にロックすると, コールバック関数が停止するだけでなく, 他のスレッドも停止する.

## バージョン

SDL 2.0.0以降

## 関連項目(関数)

SDL_UnlockAudioDevice

## SDL Wikiへのリンク

SDL_LockAudioDevice - SDL Wiki