CTRDG_IsOptionCartridgePulledOut

C Specification

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

Arguments

None.

Return Values

Returns TRUE if removal of option Game Pak was detected. Otherwise, returns FALSE. Always returns TRUE after detecting removal of option Game Pak one time.

Description

Detects removal of option Game Pak.

Note that you cannot detect removal with (CTRDG_IsOptionCartridge() && 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_IsAgbCartridgePulledOut, CTRDG_IsOptionCartridge, CTRDG_IsPulledOut, CTRDG_IsExisting

Revision History

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