NAME

FLUSH DEVICE EVENTS − remove all entries generated by a specified input device from the input event queue

SYNOPSIS

C Syntax

void
pflush_events ( ws, class, dev )
Pintws; workstation identifier
Pin_classclass; device class
Pintdev; logical input device number

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use FLUSH DEVICE EVENTS to remove all the events in the input queue that were generated by a specified input device. 

C Input Parameters

wsThe workstation identifier of the workstation associated with the input device. 

classThe input class of the input device.  Pin_class is an enumerated type defined in phigs.h that may take the following values:

•  PIN_NONE
•  PIN_LOC
•  PIN_STROKE
•  PIN_VAL
•  PIN_CHOICE
•  PIN_PICK
•  PIN_STRING

devThe device number of the input device. 

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

061Ignoring function, specified workstation is neither of category INPUT nor of category OUTIN

250Ignoring function, the specified device is not available on the specified workstation

256Warning, the input queue has overflowed

SEE ALSO

AWAIT EVENT (3P)

September 02, 1992