GPHIGS C FUNCTIONS - INQUIRE INPUT QUEUE OVERFLOW

INQUIRE INPUT QUEUE OVERFLOW

PINQ_IN_OVERF

CALL SEQUENCE

void pinq_in_overf(

Pint	*error_ind,	/* (out) error indicator	*/
Pint 	*ws_id,	/* (out) workstation identifier	*/
Pin_class	*class,	/* (out) input class	*/
Pint 	*dev	/* (out) input device number	*/

TYPES

typedef enum {
	PIN_NONE, 
	PIN_LOC, 
	PIN_STROKE, 
	PIN_VAL, 
	PIN_CHOICE, 
	PIN_PICK, 
	PIN_STRING
} Pin_class;

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Returns a description of the event which caused the input event queue overflow, if there has been an overflow since OPEN PHIGS or since the last call to this function. If the data is available, error indicator is returned as 0.

The description is read from the PHIGS error state list. After reading, the description is deleted from this list.

ERRORS

3: Ignoring function, function requires state (PHOP, WSOP,*,*)
257: Ignoring function, input queue has not overflowed, since OPEN PHIGS or last invocation of INQUIRE INPUT QUEUE OVERFLOW
258: Ignoring function, input queue has overflowed, but associated workstation has been closed