## Input/Output Device Driver Reference

[prev][next][parent][TOC]

### Query_Activity

This function is started by another physical device driver to get the current Mouse Activity Status, in relation to the last time this function was called or because the caller's handle was opened. This function does not provide the caller with the current Mouse State. It provides only the data from a last-call perspective. A return value of 0 in the BX register ( without an error condition) indicates that no mouse device activity has been recorded since the last call. In addition, the return status is on a system-wide basis (that is, there is no evaluation for a particular session 's activity). If the input Mouse IDC handle is invalid, then an INVALID_ HANDLE error code is returned.

Input: AX = Query_Activity function request code, 0006H
BX = Mouse IDC handle
DS = MOUSE$ DD DS value
ES = Calling DD DS value
CX = Undefined
DX = Undefined
SI = Undefined
DI = Undefined

Output: AX = Error Return code if Carry is set; undefined if Carry is clear
BX = Mouse Activity Status
DS = MOUSE$ DD DS value
ES = Calling DD DS value
CX = Undefined
DX = Undefined
SI = Undefined
DI = Undefined

The Mouse Activity Status is a returned bit mask. A set bit is defined as having a value of 1. A set bit indicates that the description status or event occurred. The bit definitions for the Mouse Activity Status parameter are as follows:

Bits 15-11 Reserved=0
Bit 10 Button 5 usage, without motion
Bit 9 Button 5 usage, with motion
Bit 8 Button 4 usage, without motion
Bit 7 Button 4 usage, with motion
Bit 6 Button 3 usage, without motion
Bit 5 Button 3 usage, with motion
Bit 4 Button 2 usage, without motion
Bit 3 Button 2 usage, with motion
Bit 2 Button 1 usage, without motion
Bit 1 Button 1 usage, with motion
Bit 0 Pure motion was recorded.

Note: The Mouse device-dependent IDC Interface allows a device with up to five buttons to be supported. The OS/2 operating system provides specific device support for only two-button and three-button pointing devices.

Error Return Codes: INVALID_HANDLE

UNKNOWN_COMMAND

Remarks This function is valid only when OS/2 AIM Support is enabled. When Special Needs Support is inactive (AIM_Active = FALSE), IDC Query_Activity function requests are not allowed, and are returned to the caller with an UNKNOWN_COMMAND error code. For information on OS/2 AIM Support for physical device drivers, refer to Category 0Bh regarding System Notifications for Physical Device Drivers in the OS/2 Physical Device Driver Reference.