CARD_LockBackup

Syntax

#include <nitro/card.h>

void CARD_LockBackup(u16 lock_id);

Arguments

lock_id ID used to lock the card.
This is obtained with the OS_GetLockID function.

Return Values

None.

Description

This function locks the access bus to the CARD backup device. If another module (with another ID) has already locked the bus, CARD_LockRom waits until the bus returns to an unlocked state before it executes The function will return control after locking the card.

Note

All functions that access a CARD backup 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_GetLockID, OS_LockCard, OS_LockCartridge, CARD_UnlockBackup

Revision History

2004/09/06 Added the description for the prototype.
2004/08/31 Added the description of function always succeeding.
2004/07/23 Changed lock ID type from u32 to u16.
2004/07/13 Addition concerning exclusive control of CARD ROM device and backup device
2004/07/10 Initial version.


CONFIDENTIAL