INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES(3P) — SUNPHIGS LIBRARY

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
pinqnuminput ( type, error_ind, numbers )
Pwstypetype;workstation type
Pint∗error_ind;OUT error indicator
Pnumdev∗numbers;OUT number of input devices

FORTRAN Syntax

SUBROUTINE pqli ( WTYPE, ERRIND, NLCD, NSKD, NVLD, NCHD, NPKD, NSTD )
INTEGERWTYPEworkstation type
INTEGERERRINDOUT error indicator
INTEGERNLCDOUT number of locator devices
INTEGERNSKDOUT number of stroke devices
INTEGERNVLDOUT number of valuator devices
INTEGERNCHDOUT number of choice devices
INTEGERNPKDOUT number of pick devices
INTEGERNSTDOUT number of string 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 Pnumdev data structure in which to return the number of devices available. Pnumdev is defined in phigs.h as follows:

typedef struct {
Pintlocator;
Pintstroke;
Pintvaluator;
Pintchoice;
Pintpick;
Pintstring;
} Pnumdev;

FORTRAN Input Parameters

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

ERRIND
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.

NLCDThe number of LOCATOR devices available with this workstation type.

NSKDThe number of STROKE devices available with this workstation type.

NVLDThe number of VALUATOR devices available with this workstation type.

NCHDThe number of CHOICE devices available with this workstation type.

NPKDThe number of PICK devices available with this workstation type.

NSTDThe number of STRING devices available with this workstation type.

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