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=utf-8">
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_InitChina</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">OS_InitChina <img src="../../image/NTR.gif" align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15  <PRE><CODE>#include &lt;nitro/os.h&gt;</CODE></PRE>
16  <PRE><CODE>void OS_InitChina( const char** isbn, OSChinaIsbn param );
17  </CODE></PRE>
18</DL>
19<H2>Arguments</H2>
20<table border="1" width="100%">
21  <TBODY>
22    <TR>
23<TD width="20%" rowspan="5"><EM><STRONG><FONT face="Courier New">isbn</FONT></STRONG></EM></TD>
24<TD colspan="4">Four ISBN-related strings displayed on the Health and Safety screen. The format of the strings is shown below. Characters other than numbers or a dash are handled as a space.</TD>
25    </TR>
26    <TR>
27      <TD width="3%"><CENTER>0</CENTER></TD>
28<TD width="12%"><CODE>char[ 17 ]</CODE></TD>
29      <TD width="20%"><CODE>&quot;***-*-******-**-*&quot;</CODE></TD>
30<TD width="45%">ISBN</TD>
31    </TR>
32    <TR>
33      <TD><CENTER>1</CENTER></TD>
34<TD><CODE>char[ 12 ]</CODE></TD>
35      <TD><CODE>&quot;***-****-***&quot;</CODE></TD>
36<TD>&#21512;&#21516;&#30331;&#35352;&#21495; (China-specific classification code)</TD>
37    </TR>
38    <TR>
39      <TD><CENTER>2</CENTER></TD>
40<TD><CODE>char[ 4 ]</CODE></TD>
41      <TD><CODE>&quot;****&quot;</CODE></TD>
42<TD>&#26032;&#20986;&#38899;&#31649; (China-specific information displayed on left side)</TD>
43    </TR>
44    <TR>
45      <TD><CENTER>3</CENTER></TD>
46<TD><CODE>char[ 3 ]</CODE></TD>
47      <TD><CODE>&quot;****&quot;</CODE></TD>
48<TD>&#26032;&#20986;&#38899;&#31649; (China-specific information displayed on right side)</TD>
49    </TR>
50    <TR>
51<TD width="20%" rowspan="4"><EM><STRONG><FONT face="Courier New">param</FONT></STRONG></EM></TD>
52<TD colspan="4">Behavior related to display of the ISBN number.</TD>
53    </TR>
54    <TR>
55<TD colspan="3"><CODE>OS_CHINA_ISBN_DISP</CODE></TD>
56<TD colspan="1">Displays the ISBN number.</TD>
57    </TR>
58    <TR>
59<TD colspan="3"><CODE>OS_CHINA_ISBN_NO_DISP</CODE></TD>
60<TD colspan="1">Do not display the ISBN number. (A Health and Safety screen is also not displayed.)</FONT></TD>
61    </TR>
62    <TR>
63<TD colspan="3"><CODE>OS_CHINA_ISBN_CHECK_ROM</CODE></TD>
64<TD colspan="1">Specify this when creating ROMs for censoring. This always displays the ISBN number and waits for button input on the Health and Safety screen.</TD>
65    </TR>
66  </TBODY>
67</table>
68
69<H2>Return Values</H2>
70<P>None.</P>
71
72<H2>Description</H2>
73<P>This function checks hardware startup restrictions after the system is initialized, in the same way as the <A href="OS_Init.html"><CODE>OS_Init</CODE></A> function.</P>
74<P>If an application designed for China is launched properly on a Chinese-market console, this function displays the Health and Safety screen and also displays other mandatory information, such as the ISBN number. However, if <CODE>OS_CHINA_ISBN_NO_DISP</CODE> is specified in <SPAN class="argument">param</SPAN>, the Health and Safety screen is not displayed and the ISBN number is not indicated.</P>
75<P>The string, such as the ISBN number, displayed on the Health and Safety screen is specified using <SPAN class="argument">isbn</SPAN>. However, if <CODE>OS_CHINA_ISBN_NO_DISP</CODE> is specified in <SPAN class="argument">param</SPAN>, <SPAN class="argument">isbn</SPAN> is not used at all because the Health and Safety screen is not displayed. (The specification is disregarded.)</P>
76<P>To make an application for China, you must use this function instead of the <A href="OS_Init.html"><CODE>OS_Init</CODE></A> function and define accompanying information in the ROM image that indicates that the application has Chinese-language support. For more information, see the description of <A href="../../tools/makerom.html"><CODE>makerom</CODE></A>.</P>
77<P>For information on system initialization, see the description of the <A href="OS_Init.html"><CODE>OS_Init</CODE></A> function.</P>
78<H2>See Also</H2>
79<P><CODE><A href="OS_Init.html">OS_Init</A></CODE>
80</P>
81<H2>Revision History</H2>
82<P>2009/11/05 Revised the description of operations when <CODE>OS_CHINA_ISBN_NO_DISP</CODE> is specified in param.<BR>2009/09/07 Revised the description of operations when <CODE>OS_CHINA_ISBN_NO_DISP</CODE> is specified in param. Revised the description of startup restrictions.<BR>2009/05/27 Added a second argument.<BR>2009/04/07 Support for display of 17-digit ISBN numbers.<BR>2005/05/14 Added to Description.<BR>2005/04/25 Initial version.
83</P>
84<hr><p>CONFIDENTIAL</p></body>
85</HTML>