SND_LockChannel

構文

#include <nitro/snd.h>
void SND_LockChannel( u32 chBitMask, u32 flags );

引数

chBitMask チャンネルビットマスクです。どのチャンネルを操作するかを指定します。
flags オプションフラグです。現在は使用しませんので0を入れます。

返り値

なし。

説明

チャンネルを直接操作できるようにロックをかけます。

どのチャンネルを操作するのかは、チャンネルビットマスクchBitMaskで指定します。各ビットは、最下位ビットがチャンネル0で、以下順にチャンネル1、チャンネル2、、、を表しています。ビットが立っているものに対応するチャンネルに対してのみ、操作を行います。

ロックをかけたチャンネルは、シーケンス再生で使用されないようになります。 すでに使用中だった場合は、強制的に発音を停止します。 ロックを解除するには、 SND_UnlockChannel() を使います。

注意

この関数は、ARM7コマンド予約関数です。 この関数を呼びだした後、 SND_FlushCommand() で コマンドを発行して始めて、処理が行われます。

また、処理の完了と同期を取る必要がある場合は、 まず、この関数呼び出しの直後に、 SND_GetCurrentCommandTag() で、コマンドタグを取得しておきます。 そしてコマンド発行後に、取得したコマンドタグを使って SND_IsFinishedCommandTag() または、 SND_WaitForCommandProc() を呼びだして、 処理の完了をチェックしたり、待ったりします。

参照

SND_UnlockChannel, SND_FlushCommand, SND_GetCurrentCommandTag, SND_IsFinishedCommandTag, SND_WaitForCommandProc

履歴

2005/02/17 ARM7コマンド処理の注意書き追加
2004/07/20 初版