Differences

This shows you the differences between two versions of the page.

--- en:docs:fapi:kbdxlate [2021/10/06 12:01] – created prokushev
+++ en:docs:fapi:kbdxlate [2021/11/04 13:25] (current) – prokushev
@@ Line 1: / Line 1: @@
+{{page>en:templates:fapiint}}
+====== KbdXlate ======
 This call translates scan codes with shift states into ASCII codes.
-==Syntax==
+===== Syntax =====
- KbdXlate (XlateRecord, KbdHandle)
+<code c>
+KbdXlate (XlateRecord, KbdHandle)
+</code>
-==Parameters==
+===== Parameters =====
-;XlateRecord (PKBDTRANS) - input: Address of the translation record structure:
-::chardata (KBDKEYINFO): Character data information structure as defined in KbdCharIn call.
-::kbdflag (USHORT): See the KbdDDFlagWord call in the "Keyboard Device Driver" section of ''IBM Operating System/2 Version 1.2 I/O Subsystems And Device Support Volume 1''.
-::xlate (USHORT): Translation flag:
-:::0 - Translation incomplete.
-:::1 - Translation complete.
-::xlatestate1 (USHORT): Identifies the state of translation across successive calls; initially the value should be zero. It may take several calls to this function to complete a character. The value should not be changed unless a new translation is required, that is, reset value to zero.
-::xlatestate2 (USHORT): See description for xlatestate1.
-;KbdHandle (HKBD) - input: Default keyboard or the logical keyboard.
-==Return Code==
+  * XlateRecord (PKBDTRANS) - input: Address of the translation record structure:
-;rc (USHORT) - return:Return code descriptions are:
+    * chardata (KBDKEYINFO): Character data information structure as defined in KbdCharIn call.
-*0 NO_ERROR
+    * kbdflag (USHORT): See the KbdDDFlagWord call in the "Keyboard Device Driver" section of ''IBM Operating System/2 Version 1.2 I/O Subsystems And Device Support Volume 1''.
-*439 ERROR_KBD_INVALID_HANDLE
+    * xlate (USHORT): Translation flag:
-*445 ERROR_KBD_FOCUS_REQUIRED
+      * 0 - Translation incomplete.
-*447 ERROR_KBD_KEYBOARD_BUSY
+      * 1 - Translation complete.
-*464 ERROR_KBD_DETACHED
+    * xlatestate1 (USHORT): Identifies the state of translation across successive calls; initially the value should be zero. It may take several calls to this function to complete a character. The value should not be changed unless a new translation is required, that is, reset value to zero.
-*504 ERROR_KBD_EXTENDED_SG
+    *xlatestate2 (USHORT): See description for xlatestate1.
+  * KbdHandle (HKBD) - input: Default keyboard or the logical keyboard.
+===== Return Code =====
+rc (USHORT) - return:Return code descriptions are:
+  *0 NO_ERROR
+  *439 ERROR_KBD_INVALID_HANDLE
+  *445 ERROR_KBD_FOCUS_REQUIRED
+  *447 ERROR_KBD_KEYBOARD_BUSY
+  *464 ERROR_KBD_DETACHED
+  *504 ERROR_KBD_EXTENDED_SG
+===== Remarks =====
-==Remarks==
 It may take several calls to complete a translation because of accent key combinations, or other complex operations.
 The Xlatestate1 and Xlatestate2 are for use by the keyboard translation routines. These fields are reserved and must only be accessed by the caller prior to starting a translation sequence and then they must be set to zero. The KbdXlate function is intended to be used for translating a particular scan code for a given shift state. The KbdXlate function is not intended to be a replacement for the OS/2 system keystroke translation function.
-==Bindings==
+===== Bindings =====
-===C===
-<PRE>
+====C====
+<code c>
 typedef struct _KBDTRANS { /* kbxl */
   UCHAR      chChar;       /* ASCII character code */
@@ Line 53: / Line 64: @@
 USHORT     rc;            /* return code */
-</PRE>
+</code>
-===MASM===
+====MASM====
-<PRE>
+<code asm>
 KBDTRANS struc
   kbxl_chChar    db  ? ;ASCII character code
@@ Line 78: / Line 89: @@
 Returns WORD
-</PRE>
+</code>
-[[Category:Kbd]]
+{{page>en:templates:fapi}}