.\"##
.\" $XConsortium: p169,v 5.2 94/04/17 20:56:24 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.ds pN INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES
.TH "\*(pN" 3P+ "29 February 1991"
.SH NAME
INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES \- inquire the number of available logical input devices for a specified workstation type
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pinq_num_avail_in ( type, error_ind, numbers )
Pint	type;	\fIworkstation type\fP
Pint	*error_ind;	\fIOUT error indicator\fP
Pnum_in	*numbers;	\fIOUT number of input devices\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, *, *)
.
.SH DESCRIPTION
.SS Purpose
Use \s-2INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES\s+2 to determine
the number of available logical input devices for a specified workstation
type.
.
.SS C Input Parameters
.IP \fItype \fP
Type of workstation.  See \s-2OPEN WORKSTATION\s+2 for a list of those
available.
.IP \fIerror_ind\fP
The error indicator.  See the \fIExecution\fP section below for a
description of its use.  See the \fIErrors\fP section below for the
possible values it may return.
.IP \fInumbers\fP
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:
.sp
.ta .5i +\w'Pint	'u +\w'choice;		'u
.nf
typedef struct {
.sp .2
	Pint	loc;	/* locators */
	Pint	stroke;	/* strokes */
	Pint	val;	/* valuators */
	Pint	choice;	/* choices */
	Pint	pick;	/* picks */
	Pint	string;	/* strings */
.sp .2
} Pnum_in;
.fi
.
.SS Execution
\s-2INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES\s+2 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 \fIerror indicator\fP will be set to one of the values
specified in the \fIErrors\fP section below and the input device
information will not be returned.
.
.SH ERRORS
.IP 002
Ignoring function, function requires state \s-2(PHOP, *, *, *)\s+2
.IP 052
Ignoring function, workstation type not recognized by the implementation
.IP 051
Ignoring function, this information is not yet available
for this workstation type; open a workstation of this type
and use the specific workstation type
.IP 061
Ignoring function, specified workstation is neither of category \s-2INPUT\s+2
nor of category \s-2OUTIN\s+2
.
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "INQUIRE WORKSTATION CONNECTION AND TYPE (3P)"
.SM "INITIALIZE CHOICE (3P)"
.SM "INITIALIZE LOCATOR (3P)"
.SM "INITIALIZE PICK (3P)"
.SM "INITIALIZE STRING (3P)"
.SM "INITIALIZE STROKE (3P)"
.SM "INITIALIZE VALUATOR (3P)"
.fi
