en:ibm:prcp:kbd:setfgnd

KbdSetFgnd

Bindings: C, MASM

This call raises the priority of the foreground keyboard's thread.

KbdSetFgnd ( )

rc (USHORT) - return Return code descriptions are:

0 NO_ERROR
447 ERROR_KBD_KEYBOARD_BUSY
504 ERROR_KBD_EXTENDED_SG

Remarks

KbdSetFgnd marks the current process that owns the keyboard. Threads in this process receive a priority boost. The previous foreground keyboard threads lose their priority boost.

This function should only be issued by a Keyboard Subsystem during KbdCharIn or KbdStringIn processing.

C bindings

#define INCL_KBD
 
USHORT  rc = KbdSetFgnd(VOID);
 
USHORT           rc;            /* return code

MASM bindings

EXTRN  KbdSetFgnd:FAR
INCL_KBD            EQU 1
 
CALL   KbdSetFgnd
 
Returns WORD