CARD_CheckPulledOut

C Specification

#include <nitro/card.h>
void CARD_CheckPulledOut( void );
  

Arguments

None.

Return Values

None.

Description

Directly executes process from the ARM9 to detect Game Card removal. Normally the ARM9 does not need this detection process, since the ARM7 periodically performs the detection process and posts notification of detection via the PXI. However, by calling this function you can immediately determine if the Game Card has been removed without the delay inherent in waiting for notification. When Game Card removal has been detected, this function internally calls the user callback function and the OS_TerminateForPulledOut function. This is the same process that occurs as when receiving notification from ARM7. In order to use this function you must call the CARD_Init function in advance. In addition, you need to have already called the CARD_LockRom function and locked the bus of the CARD-ROM. By default, when removal of the Game Card has been detected, the OS_TerminateForPulledOut function gets called inside the library. Then the program stops. Thus, in order to do things like perform polling with the CARD_IsPulledOut function you will need to set the callback to return FALSE with the CARD_SetPulledOutCallback function.

See Also

CARD_Init, CARD_LockRom, CARD_IsPulledOut, CARD_SetPulledOutCallback, CARD_TerminateForPulledOut

Revision History

08/08/2005 Added statement that the CARD_LockRom function needs to be called in advance.
06/01/2005 Initial version