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>nn::fs::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(
15nn::fs::ExtSaveDataId id,
16const void * iconData,
17size_t iconDataSize,
18u32 entryDirectory,
19u32 entryFile
20);
21</pre>
22    </div>
23<h2>Arguments</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>Success.</th>
70<td>Process was successful. The return value's <CODE>IsSuccess</CODE> function returns <CODE>true</CODE> in this state.</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>ResultArchiveInvalidated</CODE></th>
82<td>The SD Card may have been removed while data was being created.</td>
83        </tr>
84        <tr>
85<th><CODE>ResultWriteProtected</CODE></th>
86<td>The SD Card is write-protected.</td>
87        </tr>
88        <tr>
89<th><CODE>ResultMediaAccessError</CODE></th>
90<td>An error occurred while accessing the SD Card due to some cause such as a loose connection. </td>
91        </tr>
92        <tr>
93<th><CODE>ResultNotFormatted</CODE></th>
94<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>
95        </tr>
96        <tr>
97<th><CODE>ResultBadFormat</CODE></th>
98<td>The SD Card has an invalid format. You must format the SD Card.</td>
99        </tr>
100        <tr>
101<th>A value other than the above.</th>
102<td>An application bug or some other unexpected error.</td>
103        </tr>
104      </table> </div>
105<h2>Description</h2>
106    <div class="section">
107<p>Creates an expanded save data memory region.</p><p>Creates an expanded save data region corresponding to the ID. Use the expanded save data number speficied in the RSF file to specify the expanded save data ID as an argument.</p><p>Before calling this function, you must call <a href="../../nn/fs/MountExtSaveData.html"><CODE>MountExtSaveData</CODE></a> to determine whether a memory region with the same ID has already been created. To format a region, first delete it with the <a href="../../nn/fs/DeleteExtSaveData.html"><CODE>DeleteExtSaveData</CODE></a> function and then call this function.</p><p>For the icon data, specify the <CODE>icn</CODE> file output by the <CODE>ctr_makebanner32</CODE> tool.</p><p>Unless you re-create expanded save data, writes cannot exceed the specified number of directories, number of files, or data size. 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>. Use the <a href="../../nn/fs/TryCreateFile.html"><CODE>TryCreateFile</CODE></a> function, which allows you to specify a file size, when creating a file.</p><!-- write here --></div>
108<h2>Revision History</h2>
109    <div class="section">
110      <dl class="history">
111        <dt>2011/01/05</dt>
112<dd>Revised the description of <CODE>ResultMediaAccessError</CODE>.<br />
113        </dd>
114        <dt>2010/12/14</dt>
115<dd>Added return values.
116        </dd>
117        <dt>2010/11/09</dt>
118<dd>Initial version.<br />
119        </dd>
120      </dl>
121    </div>
122  </body>
123</html>