# 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