Jump to content

MouDeRegister: Difference between revisions

From EDM2
No edit summary
Ak120 (talk | contribs)
mNo edit summary
Line 1: Line 1:
{{Legacy
|RepFunc=
|Remarks=This page list the older version of the function for reference.
}}
This call deregisters a mouse subsystem previously registered within a session.  
This call deregisters a mouse subsystem previously registered within a session.  


Line 12: Line 8:


==Return Code==
==Return Code==
rc (USHORT) - return
;rc (USHORT) - return:Return code descriptions are:
Return code descriptions are:
* 0 NO_ERROR
* 0 NO_ERROR
* 385 ERROR_MOUSE_NO_DEVICE
* 385 ERROR_MOUSE_NO_DEVICE
Line 26: Line 21:
*After the owning process has released the subsystem with a MouDeRegister, any other process in the session may issue a MouRegister and therefore modify the mouse support for the entire session.
*After the owning process has released the subsystem with a MouDeRegister, any other process in the session may issue a MouRegister and therefore modify the mouse support for the entire session.


==Example Code==
==Bindings==
=== C Binding===
=== C ===
<PRE>
<PRE>
#define INCL_MOU
#define INCL_MOU
Line 33: Line 28:
USHORT  rc = MouDeRegister(VOID);
USHORT  rc = MouDeRegister(VOID);


USHORT           rc;            /* return code */
USHORT rc;            /* return code */
</PRE>
</PRE>


===MASM Binding===
===MASM===
<PRE>
<PRE>
EXTRN  MouDeRegister:FAR
EXTRN  MouDeRegister:FAR

Revision as of 23:20, 13 June 2019

This call deregisters a mouse subsystem previously registered within a session.

Syntax

MouDeRegister ()

Parameters

N/A

Return Code

rc (USHORT) - return
Return code descriptions are:
  • 0 NO_ERROR
  • 385 ERROR_MOUSE_NO_DEVICE
  • 416 ERROR_MOUSE_DEREGISTER
  • 466 ERROR_MOU_DETACHED
  • 505 ERROR_MOU_EXTENDED_SG

Remarks

Processes issuing MouDeRegister calls must conform to the following rules:

  • The process that issued the MouRegister must release the session (by a MouDeRegister) from the registered subsystem before another PID may issue MouRegister.
  • The process that issued the MouRegister is the only process that may issue MouDeRegister against the currently registered subsystem.
  • After the owning process has released the subsystem with a MouDeRegister, any other process in the session may issue a MouRegister and therefore modify the mouse support for the entire session.

Bindings

C

#define INCL_MOU

USHORT  rc = MouDeRegister(VOID);

USHORT  rc;            /* return code */

MASM

EXTRN  MouDeRegister:FAR
INCL_MOU            EQU 1

CALL   MouDeRegister

Returns WORD

Related Functions