CARD_UnlockRom

構文

#include <nitro/card.h>

void CARD_UnlockRom(u16 lock_id);

引数

lock_id カードのロックに用いたID

返り値

なし。

説明

CARD ROM デバイスへのアクセスバスをアンロックします。
他のモジュールが別のIDで解放を待っている場合、そのモジュールへアクセス権が移ります。
指定したIDが現在ロックしているものであれば、バスをアンロックした後に制御を返します。
そうでない場合は警告メッセージを出力してOS_Panic()で強制停止します。

この関数はROMが配置されているデバイスを実行時に確認し、
カードまたはカートリッジを自動的に選択した上でそのバスをアンロックします。

注意

CARD ROM デバイスへアクセスするすべての関数は、事前にアクセスバスをロックする必要があります。
また、CARD ROM デバイスとバックアップデバイスは同時にアクセスすることができません。
一方のバスがロックされている間、他方のバスのロックが待たされる点に注意してください。

参照

OS_UnlockCard, OS_UnlockCartridge, CARD_LockRom

履歴

2009/01/30 不正なロックIDに対する動作の説明を訂正
2004/09/06 プロトタイプの記述を修正
2004/08/31 関数が常に成功する旨の記述を追加
2004/08/04 説明にて、「ロックする」を「解放する」へ一箇所訂正
2004/07/23 ロックIDの型をu32からu16へ変更
2004/07/10 バスのロックおよびバックアップデバイスとの排他に関する記述追加
2004/07/05 初版