1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<TITLE>CTRDG_IsOptionCartridgePulledOut</TITLE> 8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 9</HEAD> 10<BODY> 11<H1 align="left">CTRDG_IsOptionCartridgePulledOut <IMG src="../image/NTR.gif" align="middle"></H1> 12<H2>Syntax</H2> 13<DL> 14 <DD> 15 <PRE><CODE>#include <nitro/ctrdg.h></CODE></PRE> 16 <PRE><CODE>BOOL CTRDG_IsOptionCartridgePulledOut( void ); 17 </CODE></PRE> 18</DL> 19<H2>Arguments</H2> 20<P>None.</P> 21<H2>Return Values</H2> 22<P>Returns <code>TRUE</code> if removal of option Game Pak was detected; otherwise, returns <code>FALSE</code>. Always returns <code>TRUE</code> after detecting removal of option Game Pak one time.</P> 23<H2>Description</H2> 24<P>Detects removal of option Game Pak.</P> 25<P>Note that you cannot detect removal with <code>(CTRDG_IsOptionCartridge() && CTRDG_IsPulledOut())</code>. <br> This function can be called when the cartridge bus is locked with the <a href="../os/spinLock/OS_LockCartridge.html"><CODE>OS_LockCartridge</CODE></a> function. However, while the bus is locked, the ARM7 does not detect removal automatically, so call the <A href="CTRDG_IsExisting.html"><CODE>CTRDG_IsExisting</CODE></A> function at regular intervals, such as each game frame, during which the player cannot perform a re-insert operation. (This function internally calls the <A href="CTRDG_IsExisting.html"><CODE>CTRDG_IsExisting</CODE></A> function.) 26</P> 27 28 29<H2>See Also</H2> 30<P><a href="CTRDG_Init.html"><code>CTRDG_Init</a></code>, <code><a href="CTRDG_IsAgbCartridgePulledOut.html">CTRDG_IsAgbCartridgePulledOut</a></code>, <code><a href="CTRDG_IsOptionCartridge.html">CTRDG_IsOptionCartridge</a></code>, <code><a href="CTRDG_IsPulledOut.html">CTRDG_IsPulledOut</a></code>, <code><a href="CTRDG_IsExisting.html">CTRDG_IsExisting</a></code></P> 31<H2>Revision History</H2> 32<P>2005/04/12 Added description of cartridge bus lock.<br /> 2004/10/04 Initial version. </P> 33<hr><p>CONFIDENTIAL</p></body> 34</HTML> 35