en:ibm:prcp:kbd:close

Differences

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

Link to this comparison view

Next revision		Previous revision
en:ibm:prcp:kbd:close [2014/05/13 13:56] – external edit 127.0.0.1en:ibm:prcp:kbd:close [2016/09/15 02:24] (current) – valerius
Line 1: Line 1:
 ==== KbdClose ==== ==== KbdClose ====
  
-Bindings:  +Bindings: [[close#C bindings|C]], [[close#MASM bindings|MASM]]
- +
-C: +
-<code c> +
-#define INCL_KBD +
- +
-USHORT  rc = KbdClose(KbdHandle); +
- +
-HKBD             KbdHandle;     /* Keyboard handle */ +
- +
-USHORT           rc;            /* return code */ +
-</code> +
- +
-MASM: +
-<code asm> +
-EXTRN  KbdClose:FAR +
-INCL_KBD            EQU 1 +
- +
-PUSH   WORD    KbdHandle     ;Keyboard handle +
-CALL   KbdClose +
- +
-Returns WORD +
-</code>+
  
 This call closes the existing logical keyboard identified by the keyboard handle.  This call closes the existing logical keyboard identified by the keyboard handle. 
Line 42: Line 20:
 **Remarks**  **Remarks** 
  
-KbdClose blocks while another thread has the keyboard focus (by way of KbdGetFocus) until the thread with the focus issues KbdFreeFocus. Therefore, to prevent KbdClose from blocking, it is recommended that KbdClose be issued only while the current thread has the focus. For example: +//KbdClose// blocks while another thread has the keyboard focus (by way of //[[en:ibm:prcp:kbd:getfocus|KbdGetFocus]]//) until the thread with the focus issues //[[en:ibm:prcp:kbd:freefocus|KbdFreeFocus]]//. Therefore, to prevent KbdClose from blocking, it is recommended that //KbdClose// be issued only while the current thread has the focus. For example: 
  
   * KbdGetFocus Wait until focus available on handle 0.    * KbdGetFocus Wait until focus available on handle 0. 
Line 49: Line 27:
   * KbdClose Close still another logical keyboard handle.    * KbdClose Close still another logical keyboard handle. 
   * KbdFreeFocus Give up the focus on handle 0.    * KbdFreeFocus Give up the focus on handle 0. 
 +
 +=== C bindings ===
 +
 +<code c>
 +#define INCL_KBD
 +
 +USHORT  rc = KbdClose(KbdHandle);
 +
 +HKBD             KbdHandle;     /* Keyboard handle */
 +
 +USHORT           rc;            /* return code */
 +</code>
 +
 +=== MASM bindings ===
 +
 +<code asm>
 +EXTRN  KbdClose:FAR
 +INCL_KBD            EQU 1
 +
 +PUSH   WORD    KbdHandle     ;Keyboard handle
 +CALL   KbdClose
 +
 +Returns WORD
 +</code>