CARD_UnlockBackup

構文

#include <nitro/card.h>

void CARD_UnlockBackup(u16 lock_id);

引数

返り値

なし。

説明

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

注意

• CARD バックアップデバイスへアクセスするすべての関数は、事前にアクセスバスをロックする必要があります。 また、CARD ROM デバイスとバックアップデバイスは同時にアクセスすることができません。 一方のバスがロックされている間、他方のバスのロックが待たされる点に注意してください。
• バックアップデバイスの非同期処理を実行している間はアクセスバスを解放することはできません。 そのようなタイミングでこの関数が呼び出された場合、CARDライブラリは内部で強制的に非同期処理の完了まで待機したうえでバスを解放します。

参照

OS_UnlockCard, OS_UnlockCartridge, CARD_LockBackup

履歴

2009/01/30 不正なロックIDに対する動作の説明を訂正
2007/04/04 バックアップ処理中にバスを解放できない旨の記述を追加
2004/09/06 プロトタイプの記述を修正
2004/08/31 関数が常に成功する旨の記述を追加
2004/07/23 ロックIDの型をu32からu16へ変更
2004/07/13 CARD ROM デバイスとバックアップデバイスの排他制御に関して追加
2004/07/10 初版