[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPRQCH - Request Choice

GPRQCH (wsid, device, status, choice)

Purpose

Use GPRQCH to have the graPHIGS API execute a request to the specified choice device. The choice input value, which is the current measure of the choice device, is returned.

A status of 1=NONE means that a break action occurred.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

Choice device number (>=1)

status -- returned by the graPHIGS API, fullword integer

Status (1=NONE, 2=OK )

choice -- returned by the graPHIGS API, fullword integer

Choice number.

A choice number of zero means no choice.

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
140
DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
141
INPUT DEVICE NOT IN CORRECT MODE
168
INPUT DEVICE IS CURRENTLY OWNED BY ANOTHER CONNECTION

Related Subroutines

GPCHMO
Set Choice Mode
GPINCH
Initialize Choice
GPQLI
Inquire List of Logical Input Devices

RCP code

201335562 (X'0C00230A')


[ Previous | Next | Contents | Glossary | Home | Search ]