INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES(3P+) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES − inquire the number of available logical input devices for a specified workstation type

SYNOPSIS

C Syntax

void
pinq_num_avail_in ( type, error_ind, numbers )
Pinttype;workstation type
Pint∗error_ind;OUT error indicator
Pnum_in∗numbers;OUT number of input devices

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES to determine the number of available logical input devices for a specified workstation type.

C Input Parameters

type
Type of workstation. See OPEN WORKSTATION for a list of those available.

error_ind
The error indicator. See the Execution section below for a description of its use. See the Errors section below for the possible values it may return.

numbers
A pointer to a Pnum_in data structure in which to return the number of devices available. Pnum_in is defined in phigs.h as follows:

typedef struct {
Pintloc;/∗ locators ∗/
Pintstroke;/∗ strokes ∗/
Pintval;/∗ valuators ∗/
Pintchoice;/∗ choices ∗/
Pintpick;/∗ picks ∗/
Pintstring;/∗ strings ∗/
} Pnum_in;

Execution

INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES returns the number of input devices available of each input class for a given workstation type. If no errors are detected the numbers are returned. If an error is detected, the error indicator will be set to one of the values specified in the Errors section below and the input device information will not be returned.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

052Ignoring function, workstation type not recognized by the implementation

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

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

Museum