OS_InitChina

Syntax

#include <nitro/os.h>

void OS_InitChina( const char** isbn, OSChinaIsbn param );

Arguments

isbn	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.
	0	`char[ 17 ]`	`"**--****--*"`	ISBN
	1	`char[ 12 ]`	`"*--*"`	合同登記号 (China-specific classification code)
	2	`char[ 4 ]`	`"****"`	新出音管 (China-specific information displayed on left side)
	3	`char[ 3 ]`	`"****"`	新出音管 (China-specific information displayed on right side)
param	Behavior related to display of the ISBN number.
	`OS_CHINA_ISBN_DISP`			Displays the ISBN number.
	`OS_CHINA_ISBN_NO_DISP`			Do not display the ISBN number. (A Health and Safety screen is also not displayed.)
	`OS_CHINA_ISBN_CHECK_ROM`			Specify this when creating ROMs for censoring. This always displays the ISBN number and waits for button input on the Health and Safety screen.

Return Values

None.

Description

This function checks hardware startup restrictions after the system is initialized, in the same way as the OS_Init function.

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 OS_CHINA_ISBN_NO_DISP is specified in param, the Health and Safety screen is not displayed and the ISBN number is not indicated.

The string, such as the ISBN number, displayed on the Health and Safety screen is specified using isbn. However, if OS_CHINA_ISBN_NO_DISP is specified in param, isbn is not used at all because the Health and Safety screen is not displayed. (The specification is disregarded.)

To make an application for China, you must use this function instead of the OS_Init 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 makerom.

For information on system initialization, see the description of the OS_Init function.

Revision History

2009/11/05 Revised the description of operations when OS_CHINA_ISBN_NO_DISP is specified in param.
2009/09/07 Revised the description of operations when OS_CHINA_ISBN_NO_DISP is specified in param. Revised the description of startup restrictions.
2009/05/27 Added a second argument.
2009/04/07 Support for display of 17-digit ISBN numbers.
2005/05/14 Added to Description.
2005/04/25 Initial version.