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    <style type="text/css"><!--
8      span.static_style
9      {
10        font-size			: 8pt;
11        color				: white;
12        font-weight			: bold;
13        background			: #44f;
14        border-left			: solid 1px #aaf;
15        border-top			: solid 1px #aaf;
16        border-right		: solid 1px #00c;
17        border-bottom		: solid 1px #00c;
18        padding-left		: 2px;
19        padding-right		: 2px;
20      }
21      span.virtual_style
22      {
23        font-size			 : 8pt;
24        color				 : white;
25        font-weight			: bold;
26        background			: #0a0;
27        border-left			: solid 1px #0f0;
28        border-top			: solid 1px #0f0;
29        border-right		: solid 1px #060;
30        border-bottom		: solid 1px #060;
31        padding-left		: 2px;
32        padding-right		: 2px;
33      }
34      span.protected_style
35      {
36        font-size			 : 8pt;
37        color				 : white;
38        font-weight			: bold;
39        background			: #444;
40        border-left			: solid 1px #ccc;
41        border-top			: solid 1px #ccc;
42        border-right		: solid 1px #222;
43        border-bottom		: solid 1px #222;
44        padding-left		: 2px;
45        padding-right		: 2px;
46      }
47        --></style>
48<title>nn::hio::CTR</title>
49  </head>
50  <body>
51<h1><CODE>nn::hio::CTR</CODE> Namespace</h1>
52<h2>Description</h2>
53    <div class="section">
54<p>Namespace for the CTR HIO (Host IO) functionality. <br />(This can also be written without the <CODE>::CTR</CODE> portion.)</p>Host IO provides three methods of communicating with a PC: files, serial communication, and shared memory.
55
56<H3> Files</H3><P>Files and directories on a PC can be accessed using the <a href="../../../nn/hio/CTR/HostFile/Overview.html"><CODE>nn::hio::CTR::HostFile</CODE></a> and <a href="../../../nn/hio/CTR/HostDirectoryA/Overview.html"><CODE>nn::hio::CTR::HostDirectoryA</CODE></a> classes.</P><P>
57To use the <CODE>HostFile</CODE> class, you must run the <CODE>PARTNER-CTR HIO-Daemon</CODE> on the PC.
58</P><H3> Serial Communication</H3><P>The <a href="../../../nn/hio/CTR/SerialChannel/Overview.html"><CODE>nn::hio::CTR::SerialChannel</CODE></a> class provides a means of bidirectional communication with programs running on the PC.
59            </P><P>
60The PC must be running a program that performs serial communication.
61</P><H3> Shared Memory</H3>The <a href="../../../nn/hio/CTR/SharedMemoryChannel/Overview.html"><CODE>nn::hio::CTR::SharedMemoryChannel</CODE></a> class provides shared memory that can be accessed from both the PC and the CTR system.
62            <P>
63The PC must be running a program that uses Host IO shared memory.
64</P><h3> Using Channels </h3>
65The serial communication and shared memory features of the Host IO library use channels to communicate. You can use multiple channels simultaneously. However, use a single process and a single thread for all channel operations. Serial sending and receiving can be done in separate threads.</div>
66    <a name="class" id="class">
67<h2>Classes</h2>
68      <div class="section">
69        <table class="members">
70          <tr>
71            <th>
72<a href="../../../nn/hio/CTR/HostDirectoryA/Overview.html"><CODE>nn::hio::CTR::HostDirectoryA</CODE></a>
73            </th>
74<td>Class that represents directories in the host file system. It can be used to get information about the entries that belong to directories.</td>
75          </tr>
76          <tr>
77            <th>
78<a href="../../../nn/hio/CTR/HostDirectoryW/Overview.html"><CODE>nn::hio::CTR::HostDirectoryW</CODE></a>
79            </th>
80<td>Unicode version of the <a href="../../../nn/hio/CTR/HostDirectoryA/Overview.html"><CODE>HostDirectoryA</CODE></a> class.</td>
81          </tr>
82          <tr>
83            <th>
84<a href="../../../nn/hio/CTR/HostFile/Overview.html"><CODE>nn::hio::CTR::HostFile</CODE></a>
85            </th>
86<td>Class that represents files in the host file system. It provides the ability to read from and write to files.</td>
87          </tr>
88          <tr>
89            <th>
90<a href="../../../nn/hio/CTR/SerialChannel/Overview.html"><CODE>nn::hio::CTR::SerialChannel</CODE></a>
91            </th>
92<td>Class that represents the channels used for serial communication.</td>
93          </tr>
94          <tr>
95            <th>
96<a href="../../../nn/hio/CTR/SharedMemoryChannel/Overview.html"><CODE>nn::hio::CTR::SharedMemoryChannel</CODE></a>
97            </th>
98<td>Class that represents the channels used for shared memory.</td>
99          </tr> </table>
100      </div>
101    </a> <a name="struct" id="struct">
102<h2>Structures</h2>
103      <div class="section">
104        <table class="members">
105          <tr>
106            <th>
107<a href="../../../nn/hio/CTR/HostSystemTime/Overview.html"><CODE>nn::hio::CTR::HostSystemTime</CODE></a>
108            </th>
109<td>Structure representing time stamps.</td>
110          </tr>
111          <tr>
112            <th>
113<a href="../../../nn/hio/CTR/DirectoryEntryA/Overview.html"><CODE>nn::hio::CTR::DirectoryEntryA</CODE></a>
114            </th>
115<td>Structure representing directory entries.</td>
116          </tr>
117          <tr>
118            <th>
119<a href="../../../nn/hio/CTR/DirectoryEntryW/Overview.html"><CODE>nn::hio::CTR::DirectoryEntryW</CODE></a>
120            </th>
121<td>Unicode version of the <a href="../../../../nn/hio/CTR/DirectoryEntryA/Overview.html"><CODE>DirectoryEntryA</CODE></a> class.</td>
122          </tr> </table>
123      </div>
124    </a> <a name="enum" id="enum">
125<h2>Enumerated Types</h2>
126      <div class="section">
127        <table class="members">
128          <tr>
129            <td width="100"> </td>
130            <th>
131<a href="../../../nn/hio/CTR/FileAttribute.html"><CODE>FileAttribute</CODE></a>
132            </th>
133<td>Enumerated type that represents file attributes.</td>
134          </tr> </table>
135      </div>
136    </a> <a name="constant" id="constant">
137<h2>Constants</h2>
138      <div class="section">
139        <table class="members">
140          <tr>
141            <td width="100"> </td>
142            <th>
143<span class="argument"><a href="../../../nn/hio/CTR/WORKMEMORY_SIZE.html"><CODE>WORKMEMORY_SIZE</CODE></a></span>
144            </th>
145<td>Size of the work memory required to open a channel.</td>
146          </tr>
147          <tr>
148            <td width="100"> </td>
149            <th>
150<span class="argument"><a href="../../../nn/hio/CTR/MAX_CHANNEL_NUM.html"><CODE>MAX_CHANNEL_NUM</CODE></a></span>
151            </th>
152<td>Maximum number of channels.</td>
153          </tr>
154          <tr>
155            <td width="100"> </td>
156            <th>
157<span class="argument"><a href="../../../nn/hio/CTR/MAX_PATH.html"><CODE>MAX_PATH</CODE></a></span>
158            </th>
159<td>Represents the maximum allowable path length. This value includes the null terminator at the end of the path.</td>
160          </tr> </table>
161      </div>
162    </a> <a name="function" id="function">
163<h2>Functions</h2>
164      <div class="section">
165        <table class="members">
166          <tr>
167<th class="category" colspan="3">Initialize/Finalize</th>
168          </tr>
169          <tr>
170            <td width="100">  </td>
171            <th>
172<a href="../../../nn/hio/CTR/Initialize.html"><CODE>Initialize</CODE></a>
173            </th>
174<td>Initializes the HIO library. Call this function once before using the library.</td>
175          </tr>
176          <tr>
177            <td width="100">  </td>
178            <th>
179<a href="../../../nn/hio/CTR/Finalize.html"><CODE>Finalize</CODE></a>
180            </th>
181<td>Finalizes the HIO library. Call this function once after using the library.</td>
182          </tr>
183          <tr>
184<th class="category" colspan="3">Other</th>
185          </tr>
186          <tr>
187            <td width="100">  </td>
188            <th>
189<a href="../../../nn/hio/CTR/GetHioDaemonStatus.html"><CODE>GetHioDaemonStatus</CODE></a>
190            </th>
191<td>Gets whether the <CODE>HostIO</CODE> daemon process is running on the host.</td>
192          </tr>
193          <tr>
194            <td width="100">  </td>
195            <th>
196<a href="../../../nn/hio/CTR/GetVersion.html"><CODE>GetVersion</CODE></a>
197            </th>
198<td>Gets the version of the HIO library.</td>
199          </tr>
200          <tr>
201            <td width="100">  </td>
202            <th>
203<a href="../../../nn/hio/CTR/DeleteFile.html"><CODE>DeleteFile</CODE></a>
204            </th>
205<td>Deletes a file.</td>
206          </tr>
207          <tr>
208            <td width="100">  </td>
209            <th>
210<a href="../../../nn/hio/CTR/DeleteDirectory.html"><CODE>DeleteDirectory</CODE></a>
211            </th>
212<td>Deletes a directory. The operation fails if the directory is not empty.</td>
213          </tr>
214          <tr>
215            <td width="100">  </td>
216            <th>
217<a href="../../../nn/hio/CTR/CreateDirectory.html"><CODE>CreateDirectory</CODE></a>
218            </th>
219<td>Creates a directory.</td>
220          </tr>
221          <tr>
222            <td width="100">  </td>
223            <th>
224<a href="../../../nn/hio/CTR/Rename.html"><CODE>Rename</CODE></a>
225            </th>
226<td>Changes filenames and directory names.</td>
227          </tr>
228          <tr>
229            <td width="100">  </td>
230            <th>
231<a href="../../../nn/hio/CTR/GetCurrentDirectory.html"><CODE>GetCurrentDirectory</CODE></a>
232            </th>
233<td>Gets the current directory.</td>
234          </tr>
235          <tr>
236            <td width="100">  </td>
237            <th>
238<a href="../../../nn/hio/CTR/SetCurrentDirectory.html"><CODE>SetCurrentDirectory</CODE></a>
239            </th>
240<td>Sets the current directory.</td>
241          </tr>
242          <tr>
243            <td width="100">  </td>
244            <th>
245<a href="../../../nn/hio/CTR/GetEnvironmentVariable.html"><CODE>GetEnvironmentVariable</CODE></a>
246            </th>
247<td>Gets the value of an environment variable.</td>
248          </tr>
249          <tr>
250            <td width="100">  </td>
251            <th>
252<a href="../../../nn/hio/CTR/ResultNoConnected.html"><CODE>ResultNoConnected</CODE></a>
253            </th>
254<td>Returns a <CODE>Result</CODE> value indicating that there is no connection.</td>
255          </tr>
256          <tr>
257            <td width="100">  </td>
258            <th>
259<a href="../../../nn/hio/CTR/ResultConnected.html"><CODE>ResultConnected</CODE></a>
260            </th>
261<td>Returns a <CODE>Result</CODE> value indicating that the local host is connected.</td>
262          </tr> </table>
263      </div>
264    </a>
265<h2>Revision History</h2>
266    <div class="section">
267      <dl class="history">
268        <dt>2010/03/03</dt>
269<dd>Initial version.<br />
270        </dd>
271      </dl>
272    </div>
273  <hr><p>CONFIDENTIAL</p></body>
274</html>
275