OS_UnlockCartridge

構文

#include <nitro/os.h>
s32 OS_UnlockCartridge( u16 lockID );
 

引数

locklD カートリッジのロックに用いていたID

返り値

OS_UNLOCK_SUCCESSならば、ロック解除に成功したことを表します。( 0に定義されています )
OS_UNLOCK_ERROR ならば、ロック解除エラーがあったことを表します。( 負数に定義されています )

説明

ロックを解除し、共有リソース(この関数ではカートリッジ)のアクセス権をARM7プロセッサに渡します。

ロックの解除に成功した場合にはEXMEMCNTレジスタへアクセスし、カートリッジバスへのアクセス権を開放します。

ロックしていないモジュールが実行した場合 (現在ロックしているものと異なるIDで解除を試みた場合) には解除されず、OS_UNLOCK_ERROR が返されます。

内部動作

IOレジスタの、EXMEMCNT(0x4000204)にアクセスしています。

参照

OS_LockCartridge, OS_TryLockCartridge, OS_UnlockCard, OS_GetLockID

履歴

2004/07/23 OS_UnLockCartridge → OS_UnlockCartridge に変更
2004/07/22 引数の型を u32 → u16 に変更
2004/06/21 初版