MouSynch

From EDM2
Jump to: navigation, search

This call provides synchronous access for a mouse subsystem to the mouse device driver.

Syntax

MouSynch (IOWait)

Parameters

IOWait (USHORT) - input 
Wait for access. The flag Word is defined as follows:
0 - Control immediately returned to requestor.
1 - Requestor waits until mouse device driver is free.

Return Code

rc (USHORT) - return
Return code descriptions are:
  • 0 NO_ERROR
  • 121 ERROR_SEM_TIMEOUT

Remarks

MouSynch blocks all other threads within a session until the semaphore clears (returns from the subsystem to the router). To ensure proper synchronization, MouSynch should be issued by a mouse subsystem if it intends to access dynamically modifiable shared data for each session or if it intends to issue a DosDevIOCtl. MouSynch does not protect globally shared data from threads in other sessions.

Bindings

C

#define INCL_MOU
USHORT  rc = MouSynch(IOWait);
USHORT  IOWait;        /* Indicate wait/no wait */
USHORT  rc;            /* return code */

MASM

EXTRN  MouSynch:FAR
INCL_MOU            EQU 1

PUSH   WORD    IOWait        ;Indicate wait/no wait
CALL   MouSynch

Returns WORD