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 http-equiv="Content-Style-Type" content="text/css">
6<TITLE>NWC24CreateDlVf</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<LINK rel="stylesheet" type="text/css" href="../nwc24.css">
9</HEAD>
10<BODY>
11<H1>NWC24CreateDlVf</H1>
12
13<H2>Syntax</H2>
14<DL>
15  <DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
16  <DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24CreateDlVf( <A HREF="../Types/NWC24DlTask.html">NWC24DlTask</A>* <VAR>taskPublic</VAR>, u32 <VAR>size</VAR> );</CODE></PRE>
17</DL>
18
19<H2>Description</H2>
20<P>
21Creates a VF archive (<A href="intro.html#idea">Download Box</A>) for file storage. A file of <code><var>size</var></code> bytes is created below the Home directory, so when creating a new file use <CODE>NANDCheck</CODE> beforehand.
22</P>
23
24<P>
25<STRONG>Note:</STRONG> The file size of a VF archive includes the FAT region. Consequently, the region available to the user (the maximum file size that can be downloaded) will be approximately 10 KB less.
26</P>
27
28<H2>Arguments</H2>
29<TABLE border="1" cellpadding="3" cellspacing="0.1" class="argument">
30  <TR>
31    <TD class="name"><code><VAR>taskPublic</VAR></code></TD>
32    <TD class="description">
33Pointer to the download task.
34    </TD>
35  </TR>
36  <TR>
37    <TD class="name"><code><VAR>size</VAR></code></TD>
38    <TD class="description">
39Size of the VF archive.
40    </TD>
41  </TR>
42</TABLE>
43
44<h2>Return Values</h2>
45<P>
46<code>NWC24_OK</code>: Ended normally.<BR> <code>NWC24_ERR_LIB_NOT_OPENED</code>: The library has not been opened.<BR> <code>NWC24_ERR_PROTECTED</code>: The download task is write protected.<BR> <code>NWC24_ERR_INVALID_VALUE</code>: The value of <code><VAR>taskPublic</VAR></code> is NULL, the download task is invalid, or the specified <code><VAR>size</VAR></code> was not sufficiently large.<BR> <code>NWC24_ERR_FILE_*</code>: Internal file operation error.<BR> <code>NWC24_ERR_INTERNAL_VF</code>: The VF library called internally returned an error.<BR> <code>NWC24_ERR_NAND_CORRUPT</code>: NAND_RESULT_CORRUPT occurred internally.<BR> <code>NWC24_ERR_FATAL</code>: A fatal error occurred.<BR>
47</P>
48
49<H2>See Also</H2>
50<P>
51</P>
52
53<H2>Revision History</H2>
54<P>
552008/03/10 Added a note on FAT overhead. <BR>2006/12/05 Initial version.<BR>
56</P>
57
58<hr><p>CONFIDENTIAL</p></body>
59</HTML>