DWC_StartUtility

C Specification

#include <dwc.h>

int DWC_StartUtility( void* work, int language, int param );

Description

Starts the Nintendo Wi-Fi Connection setup. When calling this function, be aware of the following:

Furthermore, after the function ends normally, be aware of the following. (nothing is processed if it ends as a result of an argument error)

The Nintendo Wi-Fi Connection settings reference files on the DS card by using the NITRO-SDK file system. Specify $(NITRODWC_ROOT)/file/dwc/utility.bin in the dwc/ directory as a root directory. If the application does not use the file system, add the following text to the RomSpec section in the ROM spec file, and call FS_Init() from the application to enable file system use.

RomSpec
{
	...
	# From here
	HostRoot	./file/dwc    # file directory name on PC
	Root	/dwc
	File	utility.bin
	# To here
}

The function DWC_StartUtilityEx is also provided for static linking of the necessary buffers.

Arguments

work Pointer to a 32-byte aligned DWC_UTILITY_WORK_SIZE byte buffer. Can be deleted after the function completes.
language Language used by the application
DWC_LANGUAGE_JAPANESE // Japanese
DWC_LANGUAGE_ENGLISH // English
DWC_LANGUAGE_FRENCH // French
DWC_LANGUAGE_GERMAN // German
DWC_LANGUAGE_ITALIAN // Italian
DWC_LANGUAGE_SPANISH // Spanish
param Specifies the destination and configuration utility start position. The support phone number displayed in the configuration utility and whether easy wireless start is used will depend on the destination.
DWC_UTILITY_TOP_MENU_FOR_USA // For North America Start from top menu
DWC_UTILITY_SETTING_FOR_USA  //For North America Start from connection target selection
DWC_UTILITY_TOP_MENU_FOR_EUR //For Europe Start from top menu
DWC_UTILITY_SETTING_FOR_EUR // For Europe Start from connection target selection
DWC_UTILITY_TOP_MENU_FOR_JPN //For Japan Start from top menu
DWC_UTILITY_SETTING_FOR_JPN //For Japan Start from connection target selection
DWC_UTILITY_TOP_MENU_COMMON //For Common Start from top menu
DWC_UTILITY_SETTING_COMMON //For Common Start from connection target selection

Language and destination combination and support phone number, use of easy wireless start

Language Destination Support phone number Easy Wireless Start Comments
Japan Japan No Yes ---
Japan Outside of Japan --- --- Error
English North America Yes No ---
English Europe/Common No No ---
English Japan --- --- Error
Neither Japanese nor English North America No No ---
Neither Japanese nor English Europe/Common No No ---
Neither Japanese nor English Japan --- --- Error

Return Values

0 Function completed normally.
Non-zero Argument error.

See Also

DWC_StartUtilityEx , DWC_SetAuthServer

Revision History

02/22/2006 Added description specific to NITRO-Composer
12/16/2005 Revisions
09/30/2005 Added notes to Description, corrected errors in Arguments, and added a table on language and market region combinations
07/22/2005 Initial version