KbdSynch
From EDM2
Legacy Function Warning | |
---|---|
It is recommended to use a newer replacement for this function. | |
Replacement: | |
Remarks: | This page list the older version of the function for reference. |
This call synchronizes access from a keyboard subsystem to the keyboard device driver.
Contents
Syntax
KbdSynch (IOWait)
Parameters
- IOWait (USHORT) - input
- Wait for the bond. Values are:
Value Definition 0 Indicates the requestor does not wait for access to the device driver. 1 Indicates the requestor waits for access to the device driver.
Return Code
rc (USHORT) - return
Return code descriptions are:
- 0 NO_ERROR
- 121 ERROR_SEM_TIMEOUT
Remarks
KbdSynch blocks all other threads within a session until return from the subsystem to the router. To ensure proper synchronization, KbdSynch should be issued by a keyboard subsystem if it intends to issue a DosDevIOCtl or access dynamically shared data. KbdSynch does not protect globally shared data from threads in other sessions.
Example Code
C Binding
#define INCL_KBD USHORT rc = KbdSynch(IOWait); USHORT IOWait; /* Indicate if wait */ USHORT rc; /* return code */
MASM Binding
EXTRN KbdSynch:FAR INCL_KBD EQU 1 PUSH WORD IOWait ;Indicate if wait CALL KbdSynch Returns WORD