Jump to content

WinCheckInput: Difference between revisions

From EDM2
Ak120 (talk | contribs)
mNo edit summary
 
Line 31: Line 31:


==Related Functions==
==Related Functions==
* MsgInputHook
* [[MsgInputHook]]


[[Category:Win]]
[[Category:Win]]

Latest revision as of 19:08, 14 May 2025

This function is specific to OS/2 Version 2.1 or higher.

This function is used in conjunction with the MsgInputHook hook to input simulated events into the Presentation Manager input processing system.

Syntax

WinCheckInput(hab)

Parameters

hab (HAB) - input
The application anchor block.

Returns

rc (BOOL) - returns
Return code.
TRUE - The system checked for mouse and keyboard input.
FALSE - An error occurred.

Remarks

This function must be called whenever an application injects simulated mouse or keyboard events using MsgInputHook, otherwise there is no guarantee when those simulated events will occur. It forces the Presentation Manager input processing system to wake up and take a look at all possible sources of input events: the MsgInputHook hook, the JournalPlaybackHook hook, and the Presentation Manager input queue that contains normal mouse and keyboard events.

Example Code

Definition

#define INCL_WININPUT /* Or use INCL_WIN, INCL_PM, */
#include <os2.h>

HAB     hab;  /*  The application anchor block. */
BOOL    rc;   /*  Return code. */

rc = WinCheckInput(hab);

Related Functions