KbdFreeFocus: Difference between revisions

Latest revision as of 03:11, 2 January 2020

This call frees the logical-to-physical keyboard bond created by KbdGetFocus.

Syntax

KbdFreeFocus (KbdHandle)

Parameters

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

464 ERROR_KBD_DETACHED

504 ERROR_KBD_EXTENDED_SG

Remarks

KbdFreeFocus may be replaced by issuing KbdRegister. Unlike other keyboard subsystem functions, the replaced KbdFreeFocus is called only if there is an outstanding focus.

Bindings

C

#define INCL_KBD

USHORT  rc = KbdFreeFocus(KbdHandle);
HKBD    KbdHandle;     /* Keyboard handle */

USHORT  rc;            /* return code */

MASM

EXTRN  KbdFreeFocus:FAR
INCL_KBD            EQU 1

PUSH   WORD    KbdHandle     ;Keyboard handle
CALL   KbdFreeFocus

Returns WORD

@@ Line 1: / Line 1: @@
-==Description==
+This call frees the logical-to-physical keyboard bond created by [[KbdGetFocus]].
-This call frees the logical-to-physical keyboard bond created by KbdGetFocus.
 ==Syntax==
@@ Line 6: / Line 5: @@
 ==Parameters==
-;KbdHandle (HKBD) - input : Default keyboard or the logical keyboard.
+;KbdHandle (HKBD) - input: Default keyboard or the logical keyboard.
 ==Return Code==
- rc (USHORT) - return
+;rc (USHORT) - return:Return code descriptions are:
-Return code descriptions are:
+::0 NO_ERROR
-* 0 NO_ERROR
+::439 ERROR_KBD_INVALID_HANDLE
-* 439 ERROR_KBD_INVALID_HANDLE
+::445 ERROR_KBD_FOCUS_REQUIRED
-* 445 ERROR_KBD_FOCUS_REQUIRED
+::464 ERROR_KBD_DETACHED
-* 464 ERROR_KBD_DETACHED
+::504 ERROR_KBD_EXTENDED_SG
-* 504 ERROR_KBD_EXTENDED_SG
 ==Remarks==
-KbdFreeFocus may be replaced by issuing KbdRegister. Unlike other keyboard subsystem functions, the replaced KbdFreeFocus is called only if there is an outstanding focus.
+KbdFreeFocus may be replaced by issuing [[KbdRegister]]. Unlike other keyboard subsystem functions, the replaced KbdFreeFocus is called only if there is an outstanding focus.
-==Example Code==
+==Bindings==
-=== C Binding===
+===C===
 <PRE>
 #define INCL_KBD
 USHORT  rc = KbdFreeFocus(KbdHandle);
+HKBD    KbdHandle;     /* Keyboard handle */
-HKBD             KbdHandle;     /* Keyboard handle */
+USHORT  rc;            /* return code */
-USHORT           rc;            /* return code */
 </PRE>
-===MASM Binding===
+===MASM===
 <PRE>
 EXTRN  KbdFreeFocus:FAR