CARD_UnlockRom

C Specification

#include <nitro/card.h>

void CARD_UnlockRom(u16 lock_id);

Arguments

lock_id ID used for locking a card

Return Values

None.

Description

This function unlocks the access bus to a CARD ROM device. If another module (with another ID) is already waiting for the bus to unlock, access rights go to the waiting module. If the specified ID is not currently locked, nothing happens. The function will return control after locking the card. When the function executes, it checks for a device with ROM. The function automatically selects the game card or pak and releases that bus.

Caution

All functions that access a CARD ROM device must first lock the access bus.
You cannot access a CARD ROM device and a backup device simultaneously.
While one bus is locked, other bus locks are forced to wait.

See Also

OS_UnlockCard, OS_UnlockCartridge, CARD_LockRom

Revision History

09/06/2004 Corrected the description of the prototype
08/31/2004 Added description that indicates that this function will always succeed.
08/04/2004 In the description, changed "unlock" to "release."
07/23/2004 Changed lock ID type from u32 to u16.
07/10/2004 Added description concerning bus lock and exclusive control of access with backup device.
07/05/2004 Initial version.