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
22      span.virtual_style
23      {
24        font-size			 : 8pt;
25        color				 : white;
26        font-weight			: bold;
27        background			: #0a0;
28        border-left			: solid 1px #0f0;
29        border-top			: solid 1px #0f0;
30        border-right		: solid 1px #060;
31        border-bottom		: solid 1px #060;
32        padding-left		: 2px;
33        padding-right		: 2px;
34      }
35
36      span.protected_style
37      {
38        font-size			 : 8pt;
39        color				 : white;
40        font-weight			: bold;
41        background			: #444;
42        border-left			: solid 1px #ccc;
43        border-top			: solid 1px #ccc;
44        border-right		: solid 1px #222;
45        border-bottom		: solid 1px #222;
46        padding-left		: 2px;
47        padding-right		: 2px;
48      }
49        --></style>
50<title>nn::applet::CTR</title>
51  </head>
52  <body>
53<h1><CODE>nn::applet::CTR</CODE> Namespace</h1>
54<h2>Description</h2>
55    <div class="section">
56<p>The <a href="../../../nn/applet/CTR/Overview.html">CTR</a> applet namespace. <br />(This can also be written without the <CODE>::CTR</CODE> portion.)</p><!-- write here --></div>
57    <a name="class" id="class">
58<h2>Classes</h2>
59      <div class="section">
60        <table class="members">
61          <tr>
62            <th>
63<a href="../../../nn/applet/CTR/ResultNotFound/Overview.html"><CODE>nn::applet::CTR::ResultNotFound</CODE></a>
64            </th>
65<td>Indicates an attempt to get something that did not exist.</td>
66          </tr>
67          <tr>
68            <th>
69<a href="../../../nn/applet/CTR/ResultAlreadyExist/Overview.html"><CODE>nn::applet::CTR::ResultAlreadyExist</CODE></a>
70            </th>
71<td>Indicates an attempt to create or register something that already exists.</td>
72          </tr>
73          <tr>
74            <th>
75<a href="../../../nn/applet/CTR/ResultNoArea/Overview.html"><CODE>nn::applet::CTR::ResultNoArea</CODE></a>
76            </th>
77<td>Indicates a lack of free space during an attempt to run a process that required a region or resource.</td>
78          </tr>
79          <tr>
80            <th>
81<a href="../../../nn/applet/CTR/ResultNotEmpty/Overview.html"><CODE>nn::applet::CTR::ResultNotEmpty</CODE></a>
82            </th>
83<td>Indicates that during an attempt to run a process, a required buffer was in use and not empty.</td>
84          </tr>
85          <tr>
86            <th>
87<a href="../../../nn/applet/CTR/ResultNoData/Overview.html"><CODE>nn::applet::CTR::ResultNoData</CODE></a>
88            </th>
89<td>Indicates that there was no data.</td>
90          </tr>
91          <tr>
92            <th>
93<a href="../../../nn/applet/CTR/ResultNoCaller/Overview.html"><CODE>nn::applet::CTR::ResultNoCaller</CODE></a>
94            </th>
95<td>Indicates that the caller or sender does not exist.</td>
96          </tr>
97          <tr>
98            <th>
99<a href="../../../nn/applet/CTR/ResultNotAllowed/Overview.html"><CODE>nn::applet::CTR::ResultNotAllowed</CODE></a>
100            </th>
101<td>Indicates that processing was attempted from a state in which it was not allowed.</td>
102          </tr>
103          <tr>
104            <th>
105<a href="../../../nn/applet/CTR/ResultBusy/Overview.html"><CODE>nn::applet::CTR::ResultBusy</CODE></a>
106            </th>
107<td>Indicates an attempt to run a process that was busy because of a mutex or for some other reason. In this case, you can retry the process.</td>
108          </tr>
109          <tr>
110            <th>
111<a href="../../../nn/applet/CTR/ResultAlreadyInit/Overview.html"><CODE>nn::applet::CTR::ResultAlreadyInit</CODE></a>
112            </th>
113<td>Indicates that initialization has already been done.</td>
114          </tr>
115          <tr>
116            <th>
117<a href="../../../nn/applet/CTR/ResultDifferentMode/Overview.html"><CODE>nn::applet::CTR::ResultDifferentMode</CODE></a>
118            </th>
119<td>Indicates differing modes.</td>
120          </tr>
121          <tr>
122            <th>
123<a href="../../../nn/applet/CTR/ResultDifferentVersion/Overview.html"><CODE>nn::applet::CTR::ResultDifferentVersion</CODE></a>
124            </th>
125<td>Indicates differing versions.</td>
126          </tr>
127          <tr>
128            <th>
129<a href="../../../nn/applet/CTR/ResultTransitionBusy/Overview.html"><CODE>nn::applet::CTR::ResultTransitionBusy</CODE></a>
130            </th>
131<td>Indicates that another transition is in progress.</td>
132          </tr>
133          <tr>
134            <th>
135<a href="../../../nn/applet/CTR/ResultShutdownProcessing/Overview.html"><CODE>nn::applet::CTR::ResultShutdownProcessing</CODE></a>
136            </th>
137<td>Indicates that a shutdown is in process.</td>
138          </tr> </table>
139      </div>
140    </a> <a name="enum" id="enum">
141<h2>Enumerated Types</h2>
142      <div class="section">
143        <table class="members">
144          <tr>
145            <td width="100"> </td>
146            <th>
147<a href="../../../nn/applet/CTR/HomeButtonState.html"><CODE>HomeButtonState</CODE></a>
148            </th>
149<td>Enumerated type indicating the state of the HOME Button.</td>
150          </tr>
151          <tr>
152            <td width="100"> </td>
153            <th>
154<a href="../../../nn/applet/CTR/SleepNotificationState.html"><CODE>SleepNotificationState</CODE></a>
155            </th>
156<td>Enumerated type indicating the sleep notification state.</td>
157          </tr>
158          <tr>
159            <td width="100"> </td>
160            <th>
161<a href="../../../nn/applet/CTR/WakeupState.html"><CODE>WakeupState</CODE></a>
162            </th>
163<td>Enumerated type indicating wakeup requests.</td>
164          </tr>
165          <tr>
166            <td width="100"> </td>
167            <th>
168<a href="../../../nn/applet/CTR/QueryReply.html"><CODE>QueryReply</CODE></a>
169            </th>
170<td>Enumerated type indicating a response to a sleep query.</td>
171          </tr>
172          <tr>
173            <td width="100"> </td>
174            <th>
175<a href="../../../nn/applet/CTR/ResultDescription.html"><CODE>ResultDescription</CODE></a>
176            </th>
177<td>Module-dependent <CODE>Description</CODE> values for <a href="../../../nn/Result/Overview.html"><CODE>nn::Result</CODE></a>.</td>
178          </tr> </table>
179      </div>
180    </a> <a name="typedef" id="typedef">
181<h2><CODE>typedef</CODE> Definitions</h2>
182      <div class="section">
183        <table class="members">
184          <tr>
185            <td width="100" />
186            <th>
187<a href="../../../nn/applet/CTR/AppletId.html"><CODE>AppletId</CODE></a>
188            </th>
189<td>The Applet ID.</td>
190          </tr>
191          <tr>
192            <td width="100" />
193            <th>
194<a href="../../../nn/applet/CTR/AppletAttr.html"><CODE>AppletAttr</CODE></a>
195            </th>
196<td>The Applet attributes.</td>
197          </tr>
198          <tr>
199            <td width="100" />
200            <th>
201<a href="../../../nn/applet/CTR/AppletHomeButtonCallback.html"><CODE>AppletHomeButtonCallback</CODE></a>
202            </th>
203<td>The type of the callback function invoked when HOME is pressed.</td>
204          </tr>
205          <tr>
206            <td width="100" />
207            <th>
208<a href="../../../nn/applet/CTR/AppletSleepQueryCallback.html"><CODE>AppletSleepQueryCallback</CODE></a>
209            </th>
210<td>The type of the callback function invoked by a sleep query.</td>
211          </tr>
212          <tr>
213            <td width="100" />
214            <th>
215<a href="../../../nn/applet/CTR/AppletSleepCanceledCallback.html"><CODE>AppletSleepCanceledCallback</CODE></a>
216            </th>
217<td>Function type representing a sleep cancel callback.</td>
218          </tr>
219          <tr>
220            <td width="100" />
221            <th>
222<a href="../../../nn/applet/CTR/AppletAwakeCallback.html"><CODE>AppletAwakeCallback</CODE></a>
223            </th>
224<td>The type of the callback function invoked upon awaking from sleep states.</td>
225          </tr>
226          <tr>
227            <td width="100" />
228            <th>
229<a href="../../../nn/applet/CTR/AppletPowerButtonCallback.html"><CODE>AppletPowerButtonCallback</CODE></a>
230            </th>
231<td>The type of the callback function invoked when POWER is pressed.</td>
232          </tr> </table>
233      </div>
234    </a> <a name="constant" id="constant">
235<h2>Constants</h2>
236      <div class="section">
237        <table class="members">
238          <tr>
239            <td width="100"> </td>
240            <th>
241<span class="argument"><a href="../../../nn/applet/CTR/WAIT_INFINITE.html"><CODE>WAIT_INFINITE</CODE></a></span>
242            </th>
243<td>The function continues running until a result is obtained. (Used by applet library functions that specify a time.)</td>
244          </tr>
245          <tr>
246            <td width="100"> </td>
247            <th>
248<span class="argument"><a href="../../../nn/applet/CTR/NO_WAIT.html"><CODE>NO_WAIT</CODE></a></span>
249            </th>
250<td>The function only runs once and does not repeat even if no results are obtained. (Used by applet library functions that specify a time.)</td>
251          </tr> </table>
252      </div>
253    </a> <a name="function" id="function">
254<h2>Functions</h2>
255      <div class="section">
256        <table class="members">
257          <tr>
258<th class="category" colspan="3">Initialization</th>
259          </tr>
260          <tr>
261            <td width="100">  </td>
262            <th>
263<a href="../../../nn/applet/CTR/Enable.html"><CODE>Enable</CODE></a>
264            </th>
265<td>Enables features specific to the applet library.</td>
266          </tr>
267          <tr>
268<th class="category" colspan="3">Getting Information</th>
269          </tr>
270          <tr>
271            <td width="100">  </td>
272            <th>
273<a href="../../../nn/applet/CTR/ReceiveDeliverArg.html"><CODE>ReceiveDeliverArg</CODE></a>
274            </th>
275<td>Gets <CODE>DeliverArg</CODE> and HMAC information as well as the <CODE>UniqueId</CODE> for transmissions.</td>
276          </tr>
277          <tr>
278            <td width="100">  </td>
279            <th>
280<a href="../../../nn/applet/CTR/GetInitialWakeupState.html"><CODE>GetInitialWakeupState</CODE></a>
281            </th>
282<td>Gets &quot;wakeup&quot; information when an application is launched.</td>
283          </tr>
284          <tr>
285            <td width="100">  </td>
286            <th>
287<a href="../../../nn/applet/CTR/IsActive.html"><CODE>IsActive</CODE></a>
288            </th>
289<td>Determines whether an Applet is currently running.</td>
290          </tr>
291          <tr>
292<th class="category" colspan="3">Controlling Operations</th>
293          </tr>
294          <tr>
295            <td width="100">  </td>
296            <th>
297<a href="../../../nn/applet/CTR/WaitForRegister.html"><CODE>WaitForRegister</CODE></a>
298            </th>
299<td>Waits the allotted time for the Applet with the specified ID to be registered.</td>
300          </tr>
301          <tr>
302            <td width="100">  </td>
303            <th>
304<a href="../../../nn/applet/CTR/WaitForStarting.html"><CODE>WaitForStarting</CODE></a>
305            </th>
306<td>Waits for this object's start event.</td>
307          </tr>
308          <tr>
309<th class="category" colspan="3">Rendering Rights</th>
310          </tr>
311          <tr>
312            <td width="100">  </td>
313            <th>
314<a href="../../../nn/applet/CTR/AssignGpuRight.html"><CODE>AssignGpuRight</CODE></a>
315            </th>
316<td>Declares that the application will start rendering.</td>
317          </tr>
318          <tr>
319            <td width="100">  </td>
320            <th>
321<a href="../../../nn/applet/CTR/ReleaseGpuRight.html"><CODE>ReleaseGpuRight</CODE></a>
322            </th>
323<td>Declares that the application will release rendering rights to another program.</td>
324          </tr>
325          <tr>
326<th class="category" colspan="3">Power Button</th>
327          </tr>
328          <tr>
329            <td width="100">  </td>
330            <th>
331<a href="../../../nn/applet/CTR/IsExpectedToProcessPowerButton.html"><CODE>IsExpectedToProcessPowerButton</CODE></a>
332            </th>
333<td>Finds the state of the POWER Button.</td>
334          </tr>
335          <tr>
336            <td width="100">  </td>
337            <th>
338<a href="../../../nn/applet/CTR/ProcessPowerButton.html"><CODE>ProcessPowerButton</CODE></a>
339            </th>
340<td>Processes POWER Button transitions.</td>
341          </tr>
342          <tr>
343<th class="category" colspan="3">Exiting Programs</th>
344          </tr>
345          <tr>
346            <td width="100">  </td>
347            <th>
348<a href="../../../nn/applet/CTR/IsExpectedToCloseApplication.html"><CODE>IsExpectedToCloseApplication</CODE></a>
349            </th>
350<td>Determines whether an application should be closed.</td>
351          </tr>
352          <tr>
353            <td width="100">  </td>
354            <th>
355<a href="../../../nn/applet/CTR/PrepareToCloseApplication.html"><CODE>PrepareToCloseApplication</CODE></a>
356            </th>
357<td>Prepares to exit a program.</td>
358          </tr>
359          <tr>
360            <td width="100">  </td>
361            <th>
362<a href="../../../nn/applet/CTR/CloseApplication.html"><CODE>CloseApplication</CODE></a>
363            </th>
364<td>Exits the program.</td>
365          </tr>
366          <tr>
367<th class="category" colspan="3">HOME Menu</th>
368          </tr>
369          <tr>
370            <td width="100">  </td>
371            <th>
372<a href="../../../nn/applet/CTR/GetHomeButtonState.html"><CODE>GetHomeButtonState</CODE></a>
373            </th>
374<td>Gets the state of the HOME Button.</td>
375          </tr>
376          <tr>
377            <td width="100">  </td>
378            <th>
379<a href="../../../nn/applet/CTR/ClearHomeButtonState.html"><CODE>ClearHomeButtonState</CODE></a>
380            </th>
381<td>Clears the HOME Button state.</td>
382          </tr>
383          <tr>
384            <td width="100">  </td>
385            <th>
386<a href="../../../nn/applet/CTR/IsExpectedToProcessHomeButton.html"><CODE>IsExpectedToProcessHomeButton</CODE></a>
387            </th>
388<td>Determines whether there has been a request to process the HOME Button.</td>
389          </tr>
390          <tr>
391            <td width="100">  </td>
392            <th>
393<a href="../../../nn/applet/CTR/ProcessHomeButton.html"><CODE>ProcessHomeButton</CODE></a>
394            </th>
395<td>Processes transitions to the HOME Menu.</td>
396          </tr>
397          <tr>
398<th class="category" colspan="3">Sleep</th>
399          </tr>
400          <tr>
401            <td width="100">  </td>
402            <th>
403<a href="../../../nn/applet/CTR/GetSleepNotificationState.html"><CODE>GetSleepNotificationState</CODE></a>
404            </th>
405<td>Gets the sleep notification state.</td>
406          </tr>
407          <tr>
408            <td width="100">  </td>
409            <th>
410<a href="../../../nn/applet/CTR/IsExpectedToReplySleepQuery.html"><CODE>IsExpectedToReplySleepQuery</CODE></a>
411            </th>
412<td>Checks whether the sleep notification state is waiting for a reply.</td>
413          </tr>
414          <tr>
415            <td width="100">  </td>
416            <th>
417<a href="../../../nn/applet/CTR/ClearSleepNotificationState.html"><CODE>ClearSleepNotificationState</CODE></a>
418            </th>
419<td>Clears the sleep notification state.</td>
420          </tr>
421          <tr>
422            <td width="100">  </td>
423            <th>
424<a href="../../../nn/applet/CTR/ReplySleepQuery.html"><CODE>ReplySleepQuery</CODE></a>
425            </th>
426<td>Replies to a sleep query.</td>
427          </tr>
428          <tr>
429            <td width="100">  </td>
430            <th>
431<a href="../../../nn/applet/CTR/EnableSleep.html"><CODE>EnableSleep</CODE></a>
432            </th>
433<td>Enables sleep mode.</td>
434          </tr>
435          <tr>
436            <td width="100">  </td>
437            <th>
438<a href="../../../nn/applet/CTR/DisableSleep.html"><CODE>DisableSleep</CODE></a>
439            </th>
440<td>Prohibits sleep mode.</td>
441          </tr>
442          <tr>
443<th class="category" colspan="3">Callback Settings</th>
444          </tr>
445          <tr>
446            <td width="100">  </td>
447            <th>
448<a href="../../../nn/applet/CTR/SetHomeButtonCallback.html"><CODE>SetHomeButtonCallback</CODE></a>
449            </th>
450<td>Sets the callback invoked when HOME is pressed.</td>
451          </tr>
452          <tr>
453            <td width="100">  </td>
454            <th>
455<a href="../../../nn/applet/CTR/SetPowerButtonCallback.html"><CODE>SetPowerButtonCallback</CODE></a>
456            </th>
457<td>Sets the callback invoked when POWER is pressed.</td>
458          </tr>
459          <tr>
460            <td width="100">  </td>
461            <th>
462<a href="../../../nn/applet/CTR/SetSleepQueryCallback.html"><CODE>SetSleepQueryCallback</CODE></a>
463            </th>
464<td>Sets the sleep query callback.</td>
465          </tr>
466          <tr>
467            <td width="100">  </td>
468            <th>
469<a href="../../../nn/applet/CTR/SetSleepCanceledCallback.html"><CODE>SetSleepCanceledCallback</CODE></a>
470            </th>
471<td>Sets the sleep cancel callback.</td>
472          </tr>
473          <tr>
474            <td width="100">  </td>
475            <th>
476<a href="../../../nn/applet/CTR/SetAwakeCallback.html"><CODE>SetAwakeCallback</CODE></a>
477            </th>
478<td>Sets a sleep recovery callback.</td>
479          </tr> </table>
480      </div>
481    </a>
482<h2>Revision History</h2>
483    <div class="section">
484      <dl class="history">
485        <dt>2010/11/10</dt>
486<dd>Initial version.<br />
487        </dd>
488      </dl>
489    </div>
490  <hr><p>CONFIDENTIAL</p></body>
491</html>