FLUSH DEVICE EVENTS(3P) — SUNPHIGS LIBRARY

NAME

FLUSH DEVICE EVENTS − remove all entries in the input queue from the specified logical input device generated

SYNOPSIS

C Syntax

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

FORTRAN Syntax

SUBROUTINE pflush ( WKID, ICL, IDNR )
INTEGERWKID workstation identifier
INTEGERICL input class
INTEGERIDNR 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. Pfclass is an enumerated type defined in phigs.h that may take the following values:

• PF_LOCATOR
• PF_STROKE
• PF_VALUATOR
• PF_CHOICE
• PF_PICK
• PF_STRING

devThe device number of the input device.

FORTRAN Input Parameters

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

ICLThe class of the input device. Valid classes as defined in phigs77.h are as follows:

• PLOCAT(Locator)
• PSTROK(Stroke)
• PVALUA(Valuator)
• PCHOIC(Choice)
• PPICK (Pick)
• PSTRIN(String)

IDNRThe 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

Museum