Difference between revisions of "KbdGetStatus"
From EDM2
m (Ak120 moved page OS2 API:CPI:KbdGetStatus to KbdGetStatus) |
|||
Line 1: | Line 1: | ||
− | == | + | {{Legacy |
+ | |RepFunc= | ||
+ | |Remarks=This page list the older version of the function for reference. | ||
+ | }} | ||
Returns information about the keyboard. | Returns information about the keyboard. | ||
Revision as of 02:15, 16 September 2017
Legacy Function Warning | |
---|---|
It is recommended to use a newer replacement for this function. | |
Replacement: | |
Remarks: | This page list the older version of the function for reference. |
Returns information about the keyboard.
Contents
Syntax
#define INCL_KBD #include <os2.h> PKBDINFO pkbdinfo; /* Pointer to keyboard data. */ HKBD hkbd; /* Reserved. Must be 0. */ APIRET rc; /* Return code. */ rc = KbdGetStatus(pkbdinfo, hkbd);
Parameters
- pkbdinfo (PKBDINFO) - output
- Pointer to keyboard data.
A pointer to a KBDKEYINFO structure in which the keyboard status is returned.
- hkbd (HKBD) - input
- Reserved. Must be 0.
Return Code
rc (APIRET) - returns
KbdGetStatus returns one of the following values:
- 0 NO_ERROR
- 373 ERROR_KBD_PARAMETER
- 376 ERROR_KBD_INVALID_LENGTH
- 439 ERROR_KBD_INVALID_HANDLE
- 445 ERROR_KBD_FOCUS_REQUIRED
- 447 ERROR_KBD_KEYBOARD_BUSY
- 504 ERROR_KBD_EXTENDED_SG
Remarks
Some of the keyboard status information can be changed using KbdSetStatus.
In KBDINFO, the upper byte of fsInterim is the NLS shift state. The meaning of the NLS shift varies by language. The following bits are defined to access this data:
NLSS_NLS1 (0x01) - Full-width, National layer NLSS_NLS2 (0x02) - Katakana, JAMO phonetic NLSS_NLS3 (0x04) - Hiragana, Hangeul, TsangJye NLSS_APPL (0x10) - Application bit NLSS_NLS4 (0x40) - Romanji, HanjaCsr NLSS_KANJI (0x80) - Kanji, Hanji