KBDGetAccessSticky

Syntax

#include <revolution/kbd.h>

KBDEc KBDGetAccessSticky(KBDChannel ch, BOOL *enable);

Arguments

ch Keyboard channel to query.
enable Pointer to a BOOL variable for storing the keyboard sticky key 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.
KBD_ERR_BAD_POINTER if enable is not a valid pointer.

Description

Returns the current "sticky" key state of the USB keyboard on channel ch. The returned state is written to the area pointed to by enable.

The sticky bit state controls the behavior of modifier keys that normally are active only while the keys such as Shift and Control are pressed down. With the sticky mode enabled, pressing the modifier key toggles the modifier state on or off. With the sticky mode disabled, the modifier state is only on while an appropriate modifier key is pressed down.

See Also

Keyboard API Function List

Revision History

2007/03/27 Initial version.


CONFIDENTIAL