Jump to content

KbdFreeFocus: Difference between revisions

From EDM2
Created page with "==Description== This call frees the logical-to-physical keyboard bond created by KbdGetFocus. ==Syntax== <PRE> KbdFreeFocus (KbdHandle) </PRE> ==Parameters== ; KbdHan..."
 
Ak120 (talk | contribs)
mNo edit summary
Line 1: Line 1:
==Description==
==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==
==Syntax==
<PRE>
  KbdFreeFocus (KbdHandle)
  KbdFreeFocus


    (KbdHandle)
==Parameters==
</PRE>
;KbdHandle (HKBD) - input : Default keyboard or the logical keyboard.


==Parameters==
;  KbdHandle (HKBD) - input : Default keyboard or the logical keyboard.
==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  
* 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==
==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==
==Example Code==
Line 47: Line 43:
</PRE>
</PRE>


==Related Functions==
[[Category:Kbd]]
*
 
[[Category:The OS/2 API Project]]

Revision as of 02:40, 5 December 2016

Description

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.

Example Code

C Binding

#define INCL_KBD

USHORT  rc = KbdFreeFocus(KbdHandle);

HKBD             KbdHandle;     /* Keyboard handle */

USHORT           rc;            /* return code */

MASM Binding

EXTRN  KbdFreeFocus:FAR
INCL_KBD            EQU 1

PUSH   WORD    KbdHandle     ;Keyboard handle
CALL   KbdFreeFocus

Returns WORD