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 6.5.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<TITLE>CARDProbeEx</TITLE>
9</HEAD>
10<BODY>
11<H1>CARDProbeEx</H1>
12<H2>C Specification</H2>
13<DL>
14  <DD>
15<PRE><code>#include &lt;revolution/card.h&gt;</CODE></PRE>
16<code>typedef void (*CARDCallback)( s32 chan, s32 result );</code>
17  <DD>
18<PRE><CODE>s32 CARDProbeEx(s32 chan, s32* memSize, s32* sectorSize);</CODE></PRE>
19</DL>
20<H2>Arguments</H2>
21<TABLE border="1" cellpadding="3" cellspacing="0.1">
22  <TBODY>
23    <TR>
24<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE><STRONG><EM><code>chan</code></EM></STRONG></CODE></STRONG></EM></TD>
25<TD width="520">Slot number (0: slot A, 1: slot B)</TD>
26    </TR>
27    <TR>
28<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE><STRONG><EM><code>memSize</code></EM></STRONG></CODE></STRONG></EM></TD>
29<TD width="520">Pointer to type s32 object for storing the Memory Card size in megabits. If unnecessary, specify <code>NULL</code>.</TD>
30    </TR>
31    <TR>
32<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE><STRONG><EM><code>sectorSize</code></EM></STRONG></CODE></STRONG></EM></TD>
33<TD width="520">Pointer to type s32 object for storing the Memory Card sector size in bytes. If unnecessary, specify <code>NULL</code>.</TD>
34    </TR>
35  </TBODY>
36</TABLE>
37<H2>Return Values</H2>
38<P>One of the following codes:</P>
39<TABLE border="0">
40  <TBODY>
41    <TR>
42<TD><CODE><CODE>CARD_RESULT_FATAL_ERROR</CODE></CODE></TD>
43      <TD></TD>
44    </TR>
45    <TR>
46<TD><CODE><CODE>CARD_RESULT_NOCARD</CODE></CODE></TD>
47<TD>Nothing is inserted.</TD>
48    </TR>
49    <TR>
50<TD><CODE><CODE>CARD_RESULT_BUSY</CODE></CODE></TD>
51<TD>Try again later.</TD>
52    </TR>
53    <TR>
54<TD><CODE><CODE>CARD_RESULT_WRONGDEVICE</CODE></CODE></TD>
55<TD>Found a non-Memory Card device.</TD>
56    </TR>
57    <TR>
58<TD><CODE><CODE>CARD_RESULT_READY</CODE></CODE></TD>
59<TD>Found a Memory Card.</TD>
60    </TR>
61  </TBODY>
62</TABLE>
63<P><strong>Note:</strong> the <code><a href="CARDProbeEx.html">CARDProbeEx</a></code> function returns <code>CARD_RESULT_BUSY</code> while the operating system is probing the specified Memory Card Slot. <code>CARD_RESULT_BUSY</code> usually turns into another state after a few milliseconds. <STRONG>Note:</STRONG> the <a href="CARDProbe.html"><code>CARDProbe</code></a> function returns <code>FALSE</code> if a Memory Card is not inserted or the operating system is not probing the specified slot [as of 08/13/2001].</P>
64<H2>Description</H2>
65<P>This function verifies if a Memory Card of any type is inserted in the specified slot. The Memory Card size returned will be 4, 8, 16, 32, 64, or 128 Mb. The sector size returned will be 8, 16, 32, 64, or 128 KB. <strong>A game program must support Memory Cards that have a sector size of 8 KB.</strong></P>
66<P><strong>Note:</strong> Nintendo officially discourages the current development of game programs that support Memory Cards with sectors that are not 8 KB. A game program should call the <CODE><a href="CARDProbeEx.html">CARDProbeEx</a></CODE> or <CODE><a href="CARDGetSectorSize.html">CARDGetSectorSize</a></CODE> function to verify whether the Memory Card is an 8 KB sector Memory Card before proceeding [as of 5/30/2001].</P>
67<H2>See Also</H2>
68<H2>Revision History</H2>
69<P>03/01/2006 Initial version.</P>
70</BODY>
71</HTML>