KbdSynch

From EDM2
Jump to: navigation, search

This call synchronizes access from a keyboard subsystem to the keyboard device driver.

Syntax

KbdSynch (IOWait)

Parameters

IOWait (USHORT) - input 
Wait for the bond. Values are:
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.

Bindings

C

#define INCL_KBD

USHORT  rc = KbdSynch(IOWait);

USHORT  IOWait;        /* Indicate if wait */
USHORT  rc;            /* return code */

MASM

EXTRN  KbdSynch:FAR
INCL_KBD            EQU 1

PUSH   WORD    IOWait        ;Indicate if wait
CALL   KbdSynch

Returns WORD