#include <cafe/kbd.h>

KBDEc KBDSetCountry (KBDChannel ch, KBDCountryCode country);


ch Keyboard channel to set.
country New KBDCountryCode value to be used for the keyboard.

Return Values

KBDEc Keyboard error code. KBD_SUCCESS if the call was successful.
KBD_ERR_NOT_INITIALIZED if the library was not initialized.
KBD_ERR_BAD_VALUE if ch or country is out of range.


Sets the keyboard on channel ch to the language (layout) map specified by country.

If a USB keyboard is connected when the application boots and then calls KBDSetCountry, the Num Lock LED is turned ON, but the state is not Num Lock. The right key event information cannot be obtained from the LED state. To obtain the right LED state, call KBDSetLeds and KBDSetModState.

Do Not Call From

Background Do not call this function from the background.

See Also

Keyboard API Function List

Revision History

2013-05-08 Automated cleanup pass.
2011-12-21 Moved to Cafe.
2007-03-19 Initial version.