1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7<title>CreateExtSaveData</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../nn/Overview.html">nn</a>::<a href="../../nn/fs/Overview.html">fs</a>::CreateExtSaveData</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../nn/Result/Overview.html">Result</a> CreateExtSaveData(
15     <a href="../../nn/fs/ExtSaveDataId.html">nn::fs::ExtSaveDataId</a> id,
16     const void * iconData,
17     size_t iconDataSize,
18     <a href="../../nn_types/u32.html">u32</a> entryDirectory,
19     <a href="../../nn_types/u32.html">u32</a> entryFile
20);
21</pre>
22    </div>
23<h2>Parameters</h2>
24    <div class="section">
25      <table class="arguments">
26        <thead>
27          <tr>
28            <td width="15" />
29<th>Name</th>
30<td>Description</td>
31          </tr>
32        </thead>
33        <tr>
34<td>in</td>
35<th>id</th>
36<td>Specifies the ID of the expanded save data.</td>
37        </tr>
38        <tr>
39<td>in</td>
40<th>iconData</th>
41<td>Specifies icon data.</td>
42        </tr>
43        <tr>
44<td>in</td>
45<th>iconDataSize</th>
46<td>Specifies the size of the icon data.</td>
47        </tr>
48        <tr>
49<td>in</td>
50<th>entryDirectory</th>
51<td>Specifies the number of directories to be stored in this expanded save data region.</td>
52        </tr>
53        <tr>
54<td>in</td>
55<th>entryFile</th>
56<td>Specifies the number of files to be stored in this expanded save data region.</td>
57        </tr> </table>
58    </div>
59<h2>Return Values</h2>
60<div class="section">Returns the result of the operation. <br />
61      <table class="arguments">
62        <thead>
63          <tr>
64<th>Value</th>
65<td>Description</td>
66          </tr>
67        </thead>
68        <tr>
69<th><CODE>Result::IsSuccess</CODE></th>
70<td>Process was successful.</td>
71        </tr>
72        <tr>
73<th><CODE>ResultMediaNotFound</CODE></th>
74<td>SD Card cannot be found or recognized.<br /></td>
75        </tr>
76        <tr>
77<th><CODE>ResultNotEnoughSpace</CODE></th>
78<td>The SD Card does not have the necessary free space.</td>
79        </tr>
80        <tr>
81<th><CODE>ResultWriteProtected</CODE></th>
82<td>The SD Card is write-protected.</td>
83        </tr>
84        <tr>
85<th><CODE>ResultMediaAccessError</CODE></th>
86<td>An error occurred while accessing the SD Card due to some cause such as a loose connection. </td>
87        </tr>
88        <tr>
89<th><CODE>ResultNotFormatted</CODE></th>
90<td>The process of creating data was interrupted by an error. The same error is returned when a mount operation is attempted from this state.</td>
91        </tr>
92        <tr>
93<th><CODE>ResultBadFormat</CODE></th>
94<td>The SD Card has an invalid format. You must format the SD Card.</td>
95        </tr>
96        <tr>
97<th>A value other than the above.</th>
98<td>An application bug or some other unexpected error.</td>
99        </tr>
100      </table> </div>
101<h2>Description</h2>
102    <div class="section">
103<p>Creates an expanded save data memory region.</p><p>Before calling this function, you must call the <a href="../../nn/fs/MountExtSaveData.html"><CODE>MountExtSaveData</CODE></a> function and check if a memory region with this same ID has already been created. To format the region, call the <CODE><a href="../../nn/fs/DeleteExtSaveData.html">DeleteExtSaveData</a></CODE> function to delete, and then call this function.</p><p>For the icon data, specify the ICN file output by the <CODE>ctr_makebanner32</CODE> tool.</p><p>Unless you re-create the expanded save data, writes cannot exceed the number of directories and number of files specified here. Be very careful during extended use.</p><p>You cannot change the size of files created in expanded save data memory. Consequently, you cannot create files using functions such as <a href="../../nn/fs/FileStream/TryInitialize.html"><CODE>FileStream::TryInitialize</CODE></a>. When creating files, use the <a href="../../nn/fs/TryCreateFile.html"><CODE>TryCreateFile</CODE></a> function, for which you can specify the file size.</p><h3>About the Expanded Save Data ID</h3><div class="section">
104This function creates an expanded save data region corresponding to the <SPAN class="Argument">id</SPAN> argument. For the expanded save data ID, specify the expanded save data number specified in the RSF file (the value specified by the <CODE>ExtSaveDataNumber</CODE> key name).<br />For details on RSF, see the <CODE><a href="../../../tools/ctr_makerom.html#rsf">ctr_makerom</a></CODE> reference.
105                </div></div>
106<h2>Revision History</h2>
107    <div class="section">
108      <dl class="history">
109        <dt>2012/03/01</dt>
110<dd>Deleted the text regarding the limit on data size.<br />
111        </dd>
112        <dt>2011/03/07</dt>
113<dd>Deleted <CODE>ResultArchiveInvalidated</CODE> from the return values.<br />
114        </dd>
115        <dt>2011/02/21</dt>
116<dd>Added a description of the expanded save data ID.<br />
117        </dd>
118        <dt>2011/01/05</dt>
119<dd>Revised the description of <CODE>ResultMediaAccessError</CODE>.<br />
120        </dd>
121        <dt>2010/12/14</dt>
122<dd>Added return values.
123        </dd>
124        <dt>2010/11/09</dt>
125<dd>Initial version.<br />
126        </dd>
127      </dl>
128    </div>
129  <hr><p>CONFIDENTIAL</p></body>
130</html>