MouSynch: Difference between revisions
No edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
This call provides synchronous access for a mouse subsystem to the mouse device driver. | This call provides synchronous access for a mouse subsystem to the mouse device driver. | ||
| Line 10: | Line 6: | ||
==Parameters== | ==Parameters== | ||
;IOWait (USHORT) - input : Wait for access. The flag Word is defined as follows: | ;IOWait (USHORT) - input : Wait for access. The flag Word is defined as follows: | ||
'''Value | '''Value Definition''' | ||
0 | 0 Control immediately returned to requestor. | ||
1 | 1 Requestor waits until mouse device driver is free. | ||
==Return Code== | ==Return Code== | ||
| Line 23: | Line 19: | ||
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. | 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 Binding=== | === C Binding=== | ||
<PRE> | <PRE> | ||
Revision as of 02:26, 8 October 2017
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:
Value Definition 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 Binding
#define INCL_MOU USHORT rc = MouSynch(IOWait); USHORT IOWait; /* Indicate wait/no wait */ USHORT rc; /* return code */
MASM Binding
EXTRN MouSynch:FAR INCL_MOU EQU 1 PUSH WORD IOWait ;Indicate wait/no wait CALL MouSynch Returns WORD