CTRDG_IsAgbCartridgePulledOut

C Specification

#include <nitro/ctrdg.h>
BOOL CTRDG_IsAgbCartridgePulledOut( void );
  

Arguments

None.

Return Values

Returns TRUE when removal of AGB Game Pak was detected. Otherwise, returns FALSE. Always returns TRUE after detecting removal of AGB Game Pak at least once.

Description

Detects removal of AGB Game Pak.

Note that you cannot detect removal with (CTRDG_IsAgbCartridge() && CTRDG_IsPulledOut()). This function can be called when the cartridge bus is locked with the OS_LockCartridge function. However, when the bus is locked, the ARM7 will not perform automatic release detection processing, and thus you should periodically call CTRDG_IsExisting each game frame or other interval when the player cannot reinsert. (This function internally calls CTRDG_IsExisting.)

See Also

CTRDG_Init, CTRDG_IsOptionCartridgePulledOut, CTRDG_IsAgbCartridge, CTRDG_IsPulledOut, CTRDG_IsExisting

Revision History

04/12/2005 Added description of cartridge bus lock
10/04/2004 Initial version