Difference between revisions of "KbdGetStatus"

From EDM2
Jump to: navigation, search
m (Ak120 moved page OS2 API:CPI:KbdGetStatus to KbdGetStatus)
Line 1: Line 1:
==Description==
+
{{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

Att.gif 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.

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