1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.1.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>OS_SetPrintOutput</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">OS_SetPrintOutput <IMG src="../../image/NTR.gif" align="middle"><IMG src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14<DD><CODE>#include &lt;nitro/os.h&gt;</CODE><BR> <BR> <CODE>void OS_SetPrintOutput( OSPrintOutputProc proc, int num );</CODE>
15</DL>
16<BLOCKQUOTE>
17<P><CODE><BR> (#define directives are given below.)<BR> void OS_SetPrintOutput_Arm9( int num );<BR> void OS_SetPrintOutput_Arm7( int num );<BR> void OS_SetPrintOutput_Arm9Err( int num );<BR> void OS_SetPrintOutput_Arm7Err( int num );<BR></CODE></P>
18</BLOCKQUOTE>
19<H2>Arguments</H2>
20<TABLE border="1">
21  <TBODY>
22    <TR>
23<TD><B><I>proc</I></B></TD>
24<TD>Specified processor.</TD>
25    </TR>
26    <TR>
27<TD><B><I>num</I></B></TD>
28<TD>Output window.</TD>
29    </TR>
30  </TBODY>
31</TABLE>
32<H2>Return Values</H2>
33<P>None.</P>
34<H2>Description</H2>
35<P>If the destination for debug output has not been set with a function like <CODE><A href="OS_Printf.html">OS_Printf</A></CODE>, this function specifies the default output destination to use.<BR>The setting made by this function will also apply if the output destination has been set as <CODE>OS_PRINT_OUTPUT_CURRENT</CODE>.</P>
36<P>We use the term &quot;standard output&quot; to refer to the destination for normal output, like that from <CODE><A href="OS_Printf.html">OS_Printf</A></CODE>. Likewise, we use the term &quot;error output&quot; to refer to the destination for highly urgent output, like that from <CODE><A href="OS_Panic.html">OS_Panic()</A></CODE>.</P>
37<P>The <B><I>proc</I></B> argument is a <CODE>OSPrintOutputProc</CODE>-type enumerated type, and specifies one of the following values.<BR>
38</P>
39<TABLE border="1">
40  <TBODY>
41    <TR>
42<TH>Value of <EM><STRONG>proc</STRONG></EM></TH>
43<TH>Description</TH>
44    </TR>
45    <TR>
46<TD><CODE> OS_PRINT_OUTPUT_PROC_ARM9</CODE></TD>
47<TD>Standard output for the ARM9 processor.</TD>
48    </TR>
49    <TR>
50<TD><CODE> OS_PRINT_OUTPUT_PROC_ARM7</CODE></TD>
51<TD>Standard output for the ARM7 processor.</TD>
52    </TR>
53    <TR>
54<TD><CODE> OS_PRINT_OUTPUT_PROC_ARM9ERR</CODE></TD>
55<TD>Error output for the ARM9 processor.</TD>
56    </TR>
57    <TR>
58<TD><CODE> OS_PRINT_OUTPUT_PROC_ARM7ERR</CODE></TD>
59<TD>Error output for the ARM7 processor.</TD>
60    </TR>
61  </TBODY>
62</TABLE>
63<P><BR> ARM7 settings can also be changed from the ARM9 side. The reverse is also possible.<BR>
64</P>
65<P><B><I>num</I></B> can be set to either 0-3 or <CODE>OS_PRINT_OUTPUT_NONE</CODE>.<BR>
66</P>
67<TABLE border="1">
68  <TBODY>
69    <TR>
70<TH>Value of <EM><STRONG>num</STRONG></EM></TH>
71<TH>Description</TH>
72    </TR>
73    <TR>
74      <TD><CODE> 0</CODE></TD>
75<TD>Output to output window 0.</TD>
76    </TR>
77    <TR>
78      <TD><CODE> 1</CODE></TD>
79<TD>Output to output window 1.</TD>
80    </TR>
81    <TR>
82      <TD><CODE> 2</CODE></TD>
83<TD>Output to output window 2.</TD>
84    </TR>
85    <TR>
86      <TD><CODE> 3</CODE></TD>
87<TD>Output to output window 3.</TD>
88    </TR>
89    <TR>
90<TD><CODE> OS_PRINT_OUTPUT_NONE</CODE></TD>
91<TD>Do not output.</TD>
92    </TR>
93  </TBODY>
94</TABLE>
95<P>
96<BR> <CODE>OS_SetPrintOutput<FONT color="#ff0000">_Arm9</FONT>( num )</CODE> is the <CODE>#define</CODE> directive for <CODE>OS_SetPrintOutput( <FONT color="#ff0000">OS_PRINT_OUTPUT_PROC_ARM9</FONT>, num )</CODE>.<BR><CODE>OS_SetPrintOutput<FONT color="#ff0000">_Arm7</FONT>( num )</CODE> is the <CODE>#define</CODE> directive for <CODE>OS_SetPrintOutput( <FONT color="#ff0000">OS_PRINT_OUTPUT_PROC_ARM7</FONT>, num )</CODE>.<BR><CODE>OS_SetPrintOutput<FONT color="#ff0000">_Arm9Err</FONT>( num )</CODE> is the <CODE>#define</CODE> directive for <CODE>OS_SetPrintOutput( <FONT color="#ff0000">OS_PRINT_OUTPUT_PROC_ARM9ERR</FONT>, num )</CODE>.<BR><CODE>OS_SetPrintOutput<FONT color="#ff0000">_Arm7Err</FONT>( num )</CODE> is the <CODE>#define</CODE> directive for <CODE>OS_SetPrintOutput( <FONT color="#ff0000">OS_PRINT_OUTPUT_PROC_ARM7ERR</FONT>, num )</CODE>.<BR>
97</P>
98<H2>See Also</H2>
99<P><A href="OS_Printf.html"><CODE>OS_Printf</CODE></A><BR></P>
100<H2>Revision History</H2>
101<P>2008/10/01 Corrected an argument typo.<br />2008/01/12 Initial version.</P>
102<hr><p>CONFIDENTIAL</p></body>
103</HTML>