NAME

inquire_input_capabilities − inquire capabilities of physical input device specified by fildes

SYNOPSIS

C Syntax:

void inquire_input_capabilities(fildes,events_queue,
sample_while_request,number_of_locators,number_of_valuators,
number_of_choice_devices,number_of_string_devices);
int fildes,*events_queue,*sample_while_request;
int *number_of_locators,*number_of_valuators;
int *number_of_choice_devices,*number_of_string_devices;

FORTRAN77 Syntax:

subroutine inquire_input_capabilities(fildes,
event_queue,sample_while_request,number_of_locators,
number_of_valuators,number_of_choice_devices,
number_of_string_devices)

integer*4 fildes,event_queue,sample_while_request
integer*4 number_of_locators,number_of_valuators
integer*4 number_of_choice_devices
integer*4 number_of_string_devices

Pascal Syntax:

procedure inquire_input_capabilities(fildes:integer;
var event_queue,sample_while_request,number_of_locators,
number_of_valuators,number_of_choice_devices,
number_of_string_devices:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened. 

Output Parameters

events_queue Set to the defined value:
TRUE (1) if an event queue is supported,
FALSE otherwise. 

sample_while_request
Set to the defined value:
TRUE (1) if the device can be sampled while a request is pending,
FALSE otherwise.

number_of_locators
Set to the number of locator devices supported.

number_of_valuators
Always set to 0: valuators are not supported at this time.

number_of_choice_devices
Set to the number of choice devices supported.

number_of_string_devices
Always set to 0: string devices are not supported at this time.

Discussion

Inquire_input_capabilities inquires the input capabilities of the physical device specified by fildes.  If the device exists and is initialized, the information specified is returned.  If the device does not exist or is not initialized, gerror is set and the output parameters are undefined. 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994