1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 8<title>NANDTell</title> 9</head> 10 11<body> 12 13<h1>NANDTell</h1> 14 15<h2>Syntax</h2> 16<dl><dd><pre class="construction">#include <revolution/nand.h> 17 18s32 NANDTell(NANDFileInfo *info, u32 *pos); 19</pre></dd></dl> 20 21<h2>Arguments</h2> 22<p> 23<TABLE class="arguments" border="1" > 24 <tr> 25<TH>info</TH> 26<TD>Pointer to a <CODE>NANDFileInfo</CODE> structure.</TD> 27 </tr> 28 <tr> 29<TH>pos</TH> 30<TD>Pointer to a u32-type variable that stores the current file position.</TD> 31 </tr> 32</TABLE> 33</p> 34 35<h2>Return Values</h2> 36<p> 37Returns one of the following codes. 38<p> 39<code>NAND_RESULT_OK<br> NAND_RESULT_ACCESS<br> NAND_RESULT_ALLOC_FAILED<br> NAND_RESULT_BUSY<br> NAND_RESULT_INVALID<br> NAND_RESULT_UNKNOWN<br> NAND_RESULT_FATAL_ERROR<br></code> 40</p> 41</p> 42 43<H2>Description</H2> 44<p> 45Obtains the current location in the file. 46</p> 47 48<p> 49This function sometimes puts the current thread to sleep, so it cannot be called from callback functions. For precautions related to calling similar functions, see <a href="../os/Interrupt/intro.html">Interrupts and Callback Functions</a>. 50</p> 51 52<h2>See Also</h2> 53<p class="reference"> 54<a href="./NANDTellAsync.html">NANDTellAsync</a><BR><a href="./NANDRead.html">NANDRead</a><BR><a href="./NANDReadAsync.html">NANDReadAsync</a><BR><a href="./NANDWrite.html">NANDWrite</a><BR><a href="./NANDWriteAsync.html">NANDWriteAsync</a><BR><a href="./NANDSeek.html">NANDSeek</a><BR><a href="./NANDSeekAsync.html">NANDSeekAsync</a><BR><a href="../os/Interrupt/intro.html">Interrupts and Callback Functions</a> 55</p> 56 57<H2>Revision History</H2> 58<p> 592007/09/25 Added information about the sleep status of threads.<br>2006/11/30 Added the <CODE>NAND_RESULT_ALLOC_FAILED</CODE> and <CODE>NAND_RESULT_BUSY</CODE> codes.<br>2006/06/16 Initial version.<BR> 60</p> 61 62<hr><p>CONFIDENTIAL</p></body> 63</html>