Click above to get retro games delivered to your door ever month!

 SWPKEYCLR()
------------------------------------------------------------------------------
 Purpose:
 Alter SWPKEYBRD() behaviour.

 Syntax:
 nuValue = SWPKEYCLR(nuClearCount)

 Parameters:
 nuClearCount  Count of keyboard clears to perform.

 Returns:
 The previous setting.

 Description:
 This function alters the number of times that SWPKEYBRD() clears the
 keyboard buffer between stuffing keystrokes into the child process.

 Normally, SWPKEYBRD() indicates to the child program that the keyboard
 buffer is empty between stuffing each keystroke. This prevents loss of
 keystrokes if the child program tries to clear the keyboard buffer itself by
 discarding any pending keystrokes.

 However, under multi-tasking systems, such as DESQView, the operating system
 itself polls the keyboard to detect idle time, and as a result may 'steal'
 the keyboard buffer clear signal that the swap kernel is trying to send to
 the child process. For this reason, the swap kernel sends not one, but 5
 keyboard clear signals between each keystroke, to ensure the child program
 will see at least one of them.
 If you seem to be losing keystrokes, increasing this value through the use
 of this function may help.

 Example:
 SWPKEYCLR(10)        // 10 clears between each key