CTRDG_IsAgbCartridge

C Specification

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

Arguments

None.

Return Values

Returns a value of TRUE if there is an AGB Game Pak. Otherwise, it returns a value of FALSE. Also, always returns FALSE after the Game Pak has been removed once.

Description

This function returns a BOOLEAN value to indicate if an AGB Game Pak is present.

However, this function will always return a value of FALSE after detecting the initial removal of a Game Pak. (This behavior is not limited to the AGB Game Pak.) 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_IsExisting, CTRDG_IsOptionCartridge

Revision History

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