#include <nitro/card.h>
void CARD_UnlockRom(u16 lock_id);
lock_id |
ID used for locking a card |
None.
Unlocks the access bus to a Game Card ROM device. If another module (with another ID) is already waiting for release, access rights go to the waiting module.
If the specified ID refers to a device that is currently locked, the bus is unlocked, and control is returned.
If the ID refers to a device that is not currently locked, a warning message is output, and the OS_Panic
function forcibly stops the process.
The function identifies devices with ROM when it executes, automatically selecting the Game Card or Game Pak and unlocking the bus.
All functions that access a Game Card ROM device must first lock the access bus.
You cannot access a Game Card ROM device and a backup device simultaneously.
While one bus is locked, other bus locks are forced to wait.
OS_UnlockCard
OS_UnlockCartridge
CARD_LockRom
2009/01/30 Corrected the explanation of behavior for an invalid lock ID.
2004/09/06 Corrected the description of the prototype.
2004/08/31 Added description that indicates that this function will always succeed.
2004/08/04 In Description, changed "unlock" to "release" in one place.
2004/07/23 Changed lock ID type from u32
to u16
.
2004/07/10 Added description concerning bus lock and exclusive control of access with backup device.
2004/07/05 Initial version.
CONFIDENTIAL