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 HomePage Builder 2000 V4.0.2  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>CARDSetStatusAsync</TITLE>
9</HEAD>
10<BODY>
11<H1>CARDSetStatusAsync</H1>
12<H2>C Specification</H2>
13<DL>
14  <DD>
15<pre><code>#include &lt;revolution/card.h&gt;</code></pre>
16<pre><code>#define CARD_READ_SIZE      512
17
18typedef void (*CARDCallback)( s32 chan, s32 result );</code></pre>
19  <DD>
20<PRE>s32 CARDSetStatusAsync(s32 chan, s32 fileNo, CARDStat* stat,
21CARDCallback callback );</PRE>
22</DL>
23<H2>Arguments</H2>
24<TABLE border="1" cellpadding="3" cellspacing="0.1">
25  <TBODY>
26    <TR>
27<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>chan</CODE></STRONG></EM></TD>
28<TD width="520">EXI channel number.</TD>
29    </TR>
30    <TR>
31<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE><em><strong><code>fileNo</code></strong></em></CODE></STRONG></EM></TD>
32<TD width="520">File entry number.</TD>
33    </TR>
34    <TR>
35<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE><STRONG><EM><CODE>stat</CODE></EM></STRONG></CODE></STRONG></EM></TD>
36<TD width="520">Pointer to file status to set.</TD>
37    </TR>
38    <TR>
39<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>callback</CODE></STRONG></EM></TD>
40<TD width="520">Callback function to notify about the result.</TD>
41    </TR>
42  </TBODY>
43</TABLE>
44<H2>Return Values</H2>
45<P>One of the following codes:</P>
46<P><code>CARD_RESULT_FATAL_ERROR<br> CARD_RESULT_NOCARD<br> CARD_RESULT_NOFILE<br> CARD_RESULT_NOPERM<br> CARD_RESULT_BUSY<br> CARD_RESULT_IOERROR<br> CARD_RESULT_READY</code></P>
47<H2>Description</H2>
48<P>Asynchronously sets a file status using a file number.</P>
49<P><em><strong>Note</strong></em>: <code>stat-&gt;iconAddr</code> must be <code>0xffffffff</code> (no icon) or less than <code>CARD_READ_SIZE</code>. At least one icon is required in a game file.</P>
50<P><em><strong>Note</strong></em>: The 64 byte comment data, specified by <code>start-&gt;commentAddr</code>, must not cross 8KB byte boundary of the file (i.e., the comment data must fit one of 8KB block of the file).)?</P>
51<P><STRONG><B>Note:</B></STRONG>This function is provided for debugging purposes. Applications should not use this function.</P>
52<H2>See Also</H2>
53<P><a target="contents" href="toc.html">Card Functions</a>, <br> <a href="CARDStat.html"><code>CARDStat</code></a></P>
54<H2>Revision History</H2>
55<P>2006/03/01 Initial version.</P>
56<hr>
57<P>CONFIDENTIAL</p>
58</BODY>
59</HTML>