# 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 初版