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::hid::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> 100 </table> 101 </div> 102 </a> <a name="struct" id="struct"> 103<h2>Structures</h2> 104 <div class="section"> 105 <table class="members"> 106 <tr> 107 <th> 108<a href="../../../nn/hio/CTR/HostSystemTime/Overview.html"><CODE>nn::hio::CTR::HostSystemTime</CODE></a> 109 </th> 110<td>Structure representing time stamps.</td> 111 </tr> 112 <tr> 113 <th> 114<a href="../../../nn/hio/CTR/DirectoryEntryA/Overview.html"><CODE>nn::hio::CTR::DirectoryEntryA</CODE></a> 115 </th> 116<td>Structure representing directory entries.</td> 117 </tr> 118 <tr> 119 <th> 120<a href="../../../nn/hio/CTR/DirectoryEntryW/Overview.html"><CODE>nn::hio::CTR::DirectoryEntryW</CODE></a> 121 </th> 122<td>Unicode version of the <a href="../../../../nn/hio/CTR/DirectoryEntryA/Overview.html"><CODE>DirectoryEntryA</CODE></a> class.</td> 123 </tr> 124 </table> 125 </div> 126 </a> <a name="enum" id="enum"> 127<h2>Enumerated Types</h2> 128 <div class="section"> 129 <table class="members"> 130 <tr> 131 <td width="100"> </td> 132 <th> 133<a href="../../../nn/hio/CTR/FileAttribute.html"><CODE>FileAttribute</CODE></a> 134 </th> 135<td>Enumerated type that represents file attributes.</td> 136 </tr> </table> 137 </div> 138 </a> <a name="constant" id="constant"> 139<h2>Constants</h2> 140 <div class="section"> 141 <table class="members"> 142 <tr> 143 <td width="100"> </td> 144 <th> 145<span class="argument"><a href="./WORKMEMORY_SIZE.html"><CODE>WORKMEMORY_SIZE</CODE></a></span> 146 </th> 147<td>Size of the work memory required to open a channel.</td> 148 </tr> 149 <tr> 150 <td width="100"> </td> 151 <th> 152<span class="argument"><a href="./MAX_CHANNEL_NUM.html"><CODE>MAX_CHANNEL_NUM</CODE></a></span> 153 </th> 154<td>Maximum number of channels.</td> 155 </tr> 156 <tr> 157 <td width="100"> </td> 158 <th> 159<span class="argument"><a href="./MAX_PATH.html"><CODE>MAX_PATH</CODE></a></span> 160 </th> 161<td>Represents the maximum allowable path length. This value includes the null terminator at the end of the path.</td> 162 </tr> </table> 163 </div> 164 </a> <a name="function" id="function"> 165<h2>Functions</h2> 166 <div class="section"> 167 <table class="members"> 168 <tr> 169<th class="category" colspan="3">Initialize/Finalize</th> 170 </tr> 171 <tr> 172 <td width="100"> </td> 173 <th> 174<a href="../../../nn/hio/CTR/Initialize.html"><CODE>Initialize</CODE></a> 175 </th> 176<td>Initializes the HIO library. Call this function once before using the library.</td> 177 </tr> 178 <tr> 179 <td width="100"> </td> 180 <th> 181<a href="../../../nn/hio/CTR/Finalize.html"><CODE>Finalize</CODE></a> 182 </th> 183<td>Shuts down the HIO library. Call this function once after using the library.</td> 184 </tr> 185 <tr> 186<th class="category" colspan="3">Other</th> 187 </tr> 188 <tr> 189 <td width="100"> </td> 190 <th> 191<a href="../../../nn/hio/CTR/GetVersion.html"><CODE>GetVersion</CODE></a> 192 </th> 193<td>Gets the version of the HIO library.</td> 194 </tr> 195 <tr> 196 <td width="100"> </td> 197 <th> 198<a href="../../../nn/hio/CTR/DeleteFile.html"><CODE>DeleteFile</CODE></a> 199 </th> 200<td>Deletes a file.</td> 201 </tr> 202 <tr> 203 <td width="100"> </td> 204 <th> 205<a href="../../../nn/hio/CTR/DeleteDirectory.html"><CODE>DeleteDirectory</CODE></a> 206 </th> 207<td>Deletes a directory. The operation fails if the directory is not empty.</td> 208 </tr> 209 <tr> 210 <td width="100"> </td> 211 <th> 212<a href="../../../nn/hio/CTR/CreateDirectory.html"><CODE>CreateDirectory</CODE></a> 213 </th> 214<td>Creates a directory.</td> 215 </tr> 216 <tr> 217 <td width="100"> </td> 218 <th> 219<a href="../../../nn/hio/CTR/Rename.html"><CODE>Rename</CODE></a> 220 </th> 221<td>Changes filenames and directory names.</td> 222 </tr> 223 <tr> 224 <td width="100"> </td> 225 <th> 226<a href="../../../nn/hio/CTR/GetCurrentDirectory.html"><CODE>GetCurrentDirectory</CODE></a> 227 </th> 228<td>Gets the current directory.</td> 229 </tr> 230 <tr> 231 <td width="100"> </td> 232 <th> 233<a href="../../../nn/hio/CTR/SetCurrentDirectory.html"><CODE>SetCurrentDirectory</CODE></a> 234 </th> 235<td>Sets the current directory.</td> 236 </tr> 237 <tr> 238 <td width="100"> </td> 239 <th> 240<a href="../../../nn/hio/CTR/GetEnvironmentVariable.html"><CODE>GetEnvironmentVariable</CODE></a> 241 </th> 242<td>Gets the value of an environment variable.</td> 243 </tr> 244 <tr> 245 <td width="100"> </td> 246 <th> 247<a href="../../../nn/hio/CTR/ResultNoConnected.html"><CODE>ResultNoConnected</CODE></a> 248 </th> 249<td>Returns a <CODE>Result</CODE> value indicating that there is no connection.</td> 250 </tr> 251 <tr> 252 <td width="100"> </td> 253 <th> 254<a href="../../../nn/hio/CTR/ResultConnected.html"><CODE>ResultConnected</CODE></a> 255 </th> 256<td>Returns a <CODE>Result</CODE> value indicating that there is a connection.</td> 257 </tr> </table> 258 </div> 259 </a> 260<h2>Revision History</h2> 261 <div class="section"> 262 <dl class="history"> 263 <dt>2010/03/03</dt> 264<dd>Initial version.<br /> 265 </dd> 266 </dl> 267 </div> 268 <hr><p>CONFIDENTIAL</p></body> 269</html> 270