#include <cafe/kbd.h>

KBDEc KBDSetLockProcessing(KBDChannel ch, BOOL enable);


ch Keyboard channel to set.
enable A BOOL value to be used as the modifier processing state.

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 was out of range.


Sets the current modifier processing state of the USB keyboard on channel ch.

If the lock modifier processing state is TRUE, the KBD library processes all modifier keys routinely and sets the KBDModState accordingly. A lock modifier processing state of FALSE indicates that the KBD library will not process the locking modifier key presses, and the following KBDModState will be left unchanged.

The processing of other KBDModState is still handled routinely. That is, pressing the SHIFT key will still set the KBD_MS_SHIFT bit in KBDModState, regardless of the lock modifier processing state. The KBDModState is used to convert HID code to Unicode.

The default value for enable is TRUE.

Do Not Call From

Background Do not call this function from the background.

Revision History

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