INQUIRE_REQUEST_STATUS(3G)

NAME

inquire_request_status − inquire status of a request to an input device.

SYNOPSIS

C SYNTAX

void inquire_request_status(fildes,class,ordinal,ready);
int fildes,class,ordinal,*ready

FORTRAN77 SYNTAX

subroutine inquire_request_status(fildes,class,ordinal,ready)
integer*4 fildes,class,ordinal,ready

PASCAL SYNTAX

procedure inquire_request_status(fildes,class,
ordinal:integer;var ready:integer);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: HP

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphics device is opened.
class
is one of the defined values, LOCATOR, CHOICE or ALL.
ordinal
is a logical device number ranging from 1 to number of devices of this class.

OUTPUT PARAMETER

ready
is set to TRUE (1) if there is a request ready but not yet read

DISCUSSION

Inquire_request_status inquires the status of a pending request for the device named by fildes, class, and ordinal. If class is set to ALL, then ordinal is ignored and ready returns the OR’ing of ready for each logical device of this fildes.

Ready returns TRUE (1) if there is a request ready but not yet read and FALSE (0) if there is no request pending, or the request pending is not ready.

This call may be used to poll whether a request_choice or request_locator needs to be issued, without halting the calling process to wait for an input.

Museum

Related Articles