Jump to content

KbdFreeFocus: Difference between revisions

From EDM2
No edit summary
Ak120 (talk | contribs)
m Eliminate illogical and untrue assertions
Line 1: Line 1:
{{Legacy
This call frees the logical-to-physical keyboard bond created by [[KbdGetFocus]].
|RepFunc=
|Remarks=This page list the older version of the function for reference.
}}
This call frees the logical-to-physical keyboard bond created by KbdGetFocus.


==Syntax==
==Syntax==
Line 12: Line 8:


==Return Code==
==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
Line 23: Line 18:
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>
<PRE>
#define INCL_KBD
#define INCL_KBD


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


HKBD            KbdHandle;    /* Keyboard handle */
USHORT rc;            /* return code */
 
USHORT           rc;            /* return code */
</PRE>
</PRE>


===MASM Binding===
===MASM===
<PRE>
<PRE>
EXTRN  KbdFreeFocus:FAR
EXTRN  KbdFreeFocus:FAR

Revision as of 16:11, 3 January 2019

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