graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPFLEV - Flush Device Event

GPFLEV (wsid, class, device)

Purpose

Use GPFLEV to discard all input events from the specified logical input device.

All events received from the specified input device, matching the specified device class, workstation identifier and device number, are removed from the event queue.

If the current event report includes an event matching the specified input device, the current event report is also removed.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier (event major code)

class -- specified by user, fullword integer

Device class (1=LOCATOR, 2=STROKE,3=VALUATOR, 4=CHOICE, 5=PICK, 6=STRING )

device -- specified by user, fullword integer

Device number (event minor code)

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
140: DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
147: EVENT QUEUE HAS OVERFLOWED
328: INPUT CLASS VALUE IS INVALID

Note:

The operation is performed even if error 147 occurs.

Related Subroutines

GPFWEV: Flush Workstation Event
GPQLI: Inquire List of Logical Input Devices

RCP code

201338114 (X'0C002D02')