subcalls.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
KbdXlate (1.2)
Overview                                            Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_KBD
 
USHORT KbdXlate(pkbxlKeyStroke, hkbd)
PKBDXLATE pkbxlKeyStroke;    /* pointer to structure for scan code */
HKBD hkbd;                   /* keyboard handle                    */
 
The KbdXlate function translates a scan code and its shift states into a
character value. The function uses the current translation table of the
specified logical keyboard.
 
In order to be translated, accent-key combinations, double-byte characters,
and extended ASCII characters may require several calls to the KbdXlate
function.
 
Parameter       Description
────────────────────────────────────────────────────────────────────────────
 
pkbxlKeyStroke  Points to the KBDTRANS structure that contains the scan code
                to translate. It also receives the character value when the
                function returns.
 
hkbd            Identifies the logical keyboard. The handle must have been
                created previously by using the KbdOpen function.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be one of the following:
 
     ERROR_KBD_DETACHED
     ERROR_KBD_INVALID_HANDLE
 
See Also
 
DosMonReg, KbdOpen, KbdSetCustXt, KBDTRANS