KBDGetModState

Syntax

#include <revolution/kbd.h>

KBDEc KBDGetModState(KBDChannel ch, KBDModState *modState);

Arguments

ch Keyboard channel to query.
modState Pointer to a KBDModState value for storing the current modifier 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 modState is not a valid pointer.

Description

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

The modifier key state is used by KBDTranslateHidCode to correctly translate HID codes into Unicodes. It also determines the state of the appropriate keyboard LEDs.

See Also

Keyboard Functions, Constants, Enumerations and Types

Revision History

2007/03/27 Initial version.


CONFIDENTIAL