CARD_CheckPulledOut

Syntax

#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 removal of a Game Card has been detected, this function internally calls the user callback function and the CARD_TerminateForPulledOut function. This is the same process that occurs when a notification is received from the ARM7.

To use this function, you must first call the CARD_Init function. In addition, you need to call the CARD_LockRom function and lock the CARD-ROM bus in advance. By default, the library will call the CARD_TerminateForPulledOut function when removal of a Game Card is detected. Because the program will stop at this point, if you are doing something like polling with the CARD_IsPulledOut function, you must use the CARD_SetPulledOutCallback function to set a callback that returns FALSE.

See Also

CARD_Init
CARD_LockRom
CARD_IsPulledOut
CARD_SetPulledOutCallback
CARD_TerminateForPulledOut

Revision History

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


CONFIDENTIAL