CARD_LockBackup


C Specification

#include <nitro/card.h>

void CARD_LockBackup(u16 lock_id);

Description

This function locks the access bus to the CARD backup device. If another module is already locked by another ID, this function will block the access bus until the bus is released. The function always succeeds. After the access bus locks, it returns control.

Cautions

All functions that access a CARD backup device must first lock the access bus. Also, a CARD ROM device cannot be accessed at the same time as a backup device. While one bus is locked, the lock for the other bus will be forced to wait.

Arguments

lock_id ID for card lock. This ID is acquired with the OS_GetLockID function.

Return Values

None.

See Also

OS_GetLockID, OS_LockCard, OS_LockCartridge, CARD_UnlockBackup

Revision History

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